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PREFACE 


This manual is the prime document for the XVM/DOS Monitor Software 
System and describes its features, concepts, programming, and opera- 
ting procedures. The first four chapters provide a general descrip- 
tion of the XVM/DOS System components, both hardware and software, 
fundamental system concepts, and file structures. 

The remaining six chapters deal with the XVM/DOS system at a more tech- 
nical level. They are primarily concerned with I/O programming require- 
ments and techniques under the Monitor, runtime keyboard commands, and 
operating procedures. The information in these chapters is directed 
primarily to readers who are familiar with either the FORTRAN IV language 
or the MACRO assembly language, described in the FORTRAN IV XVM Lan- 
guage Manual and the MACRO XVM Assembler Language Manual . FORTRAN users , 
however, need only be concerned with Chapters 7, 8, and 10, since FOR- 
TRAN I/O considerations are specifically covered in the FORTRAN IV XVM 
Operating Environment Manual . 

Detailed information on the internal operations of the XVM/DOS Monitor 
and its file structure as well as procedures for preparing user-created 
system software are provided in the XVM/DOS System Manual . Brief de- 
scriptions of all system programs with applicable document names are 
contained in Chapter 2 . 

A quick reference summary of the command strings, operating procedures 
and error messages for the Monitor and system programs is provided in 
the XVM/DOS Keyboard Command Guide . 




CHAPTER 1 

DISK OPERATING SYSTEM 


1.1 INTRODUCTION 


The XVM Disk Operating System (XVM/DOS) is an integrated set of soft- 
ware designed to meet the demands of research, engineering, and indus- 
trial environments. It includes the software necessary for simplfied 
programming and efficient operations. XVM/DOS (DOS) brings to the 
user the advantages of disk resident storage via rapid access to the 
system's resources. The minimum and the optional hardware supported 
by DOS is described in Section 1.2, "System Hardware." The Monitor 
System is an integrated set of commonly-used programs used for the 
development of user applications. These programs include tools for: 

Program Preparation, 

Compilation, 

Assembly, 

Debugging , and 

Execution of User Programs. 

The user controls the operating system by instructions to the Monitor. 
The Monitor runs the jobs, supervises data and file manipulation, and 
interacts with the operator/user in a simple, conversational manner. 

Within the system, data on mass storage is handled by macro statements 
used with the MACRO XVM symbolic assembler language, and by the mass 
storage language elements incorporated into the FORTRAN IV language. 

1.1.1 System Features 


Disk Resident The XVM/DOS System Software resides on 

System Software either DECdisk, Disk Pack, or Disk Cartridge. 


Interactive 

Operation 


An interactive keyboard/program Monitor 
permits device-independent programming and 
automatic calling and loading of system and 
user programs . 
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I/O Device 
Handlers 


Data and file manipulating I/O device han- 
dlers are supplied for standard system 
peripherals . 


Programmed 

Monitor 

Commands 


Input/Output programming is simplified by 
the use of a set of system commands which 
are standardized for system- supported I/O 
devices . 


Wide Addressing Range Programs can address up to 12 8K of memory. 


Conversational 

Mode 


Dynamic Storage 
Allocation 


Dynamic Buffer 
Allocation 


Disk File 
Structure 


System Utility Programs interact with the 
operator/user in a simple, conversational 
manner . 

The available disk storage is automatically 
allocated for optimum storage utilization. 

Input/Output buffers are automatically con- 
trolled by the Monitor. It allocates only 
that space which is required for the system 
and the user. 

Allows efficient use of disk capacity and 
data retrieval for processing via; 

• System supported DECdisk, Disk Cartridge 
and Disk Pack devices, providing both 
economy and storage capacity 

• High data storage capacity (Disk Pack - 
83.7 million words, DECdisk - 2.09 
million words. Disk Cartridge - 10 
million words) 

• Random/Sequential File access 

• File Protection through unique user 
directories 
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User-Created 
System Programs 


I/O Spooling 


Programming 

Languages 


Bank and Page 
Modes 


Automatic Mode 
Checking 


• Random Access - formatted as well as un- 
formatted Input/Output (FORTRAN IV) 

The user may easily incorporate his own soft- 
ware into the operating system, thereby 
tailoring the system to his hardware and 
software needs. 

Line Printer, card reader, and XY plotter 
spooling is available on systems with 
Unichannel-15 . 

Several programming languages are offered: 
FORTRAN IV, FOCAL, MACRO XVM and MACH 
(Unichannel-15 systems) 

Choice of 8K (Bank Mode) or 4K (Page Mode) 
direct addressability. 

The system verifies the various mode settings 
against available hardware. 


The system provides for several levels of user file protection. Using 
unique User Identification Codes, each user can be assured of his file 
integrity. Files are protected and invisible to other users. The 
system provides privileged access to all files via a supervisory code 
maintained by the system owner or manager. 


1 . 2 SYSTEM HARDWARE 


The Disk Operating System is defined within the limits of a particular 
XVM hardware system configuration; i.e., central processor model, 
minimum and maximum core requirements, necessary features, and types 
and numbers of peripheral devices. 
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1.2.1 Minimum Hardware Requirements 


For an XVM system 10 ' 

KP15 Central Processor 
24,576 Words of 18 Bit Memory 

LA36, LA30C, KSR33, KSR35, or VT05 Console Terminal 2 / 12 
PC15 High-Speed Paper Tape Reader/Punch 
KE15 Extended Arithmetic Element 
KW15 Real-Time Clock-*-! 

XM15-Memory System including; 10 
Wide Addressing 

Memory Protection and Relocation 
Instruction Prefetch 

Automatic Priority Interrupt . 

TC15 DECtape Control with 1 TU56 Dual DECtape Transport 4 ; or 
TC59 Magtape Control with 1 TU10, TU20 or TU30 (7 or 9-track) Magtape 
Transport 

RK15 Cartridge Disk System with RK05 Cartridge Disk Drive and 8,192 
Words of 16-Bit Core Memory; 5 or 

RP15 Disk Pack Control with one RP02 or RP03! Disk Pack Drive; or 
RF15 DECdisk Control with two RS09 DECdisk drives. 

CR11 Card Reader or CR15 Card Reader or CR03B Card Reader (Required 
Only to Utilize the BOSS XVM Feature) ^ 

LPll Line Printer or LS11 Line Printer or LV11 Electrostatic Printer; 

° r 9 

LP15 Line Printer (required only to utilize BOSS XVM feature) 


For a PDP-15 Computer System: 


KP15 Central Processor 

24,576 Words of 18-Bit Core Memory 

KSR35, KSR33 , LA30C , LA36 or VT05 Console Terminal^ 

PC15 High-Speed Paper Tape Reader/Punch 
KE15 Extended Arithmetic Element 
KW15 Real-Time Clock-*-! 

KA15 Automatic Priority Interrupt (required only for RK15 systems in 
certain configurations) 3 

TC15 DECtape control with one TU56 Dual-DECtape Transport 4 ;; or TC59 
Magtape Control with one TU10, TU20 or TU30 (7- or 9-track) Magtape 
Transport 

RF15 DECdisk Control with two RS09 DECdisk drives; or 
RP15 Disk Pack Control with all RP02/RP03 1 


Disk Pack Drive; or 

RK15 Cartridge Disk System with one RK05 Cartridge Disk Drive and 
8,192 Words of 16-Bit Core Memory^ 

CR15 Card Reader or CR11 Card Reader or CR03B Card Reader (required 
only to utilize the BOSS XVM feature) 9 
LP15 Line Printer or LPll Line Printer or LS11 Line Printer or LV11 
Electrostatic Printer (required only to utilize the BOSS XVM 
feature) ^ 


1.2.2 Optional Hardware 
For the XVM: 10 

CR15/CR11/CR03B Card Readers 
Core Memory 16-Bit (12K)^ 

Core Memory 18-Bit (ME15, MF15) (32K to 128K) 

TC15 4-TU56 Dual DECtape or TC02 8-TU55 DECtape 
RF15 8-RS09 Disk g 

RK15 8-RK05 Disk Cartridge^ 3 , 

RP15 8-RP02/RP03 Disk Packs 1 
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FP15 Floating Point Processor 
VT15 1-VT04 or VT07 Graphics Display 
LP11/LP15/LS11/LV116 Line Printer 
TC59 8-TU10/TU20/TU30 Magtape 
XY11/XY311 5 6 Plotter 
VP15A Storage Scope 

LA36/LA30C/KSR33/ASR33/KSR35/ASR35/VT05/LK35 2 ' 7 > 12 Terminal 
VW01 Writing Tablet 

For the PDP-15: 

XM15 Memory Processing Unit including: 

Wide Addressing 

Memory Protection and Relocation 
Instruction Prefetch 
Automatic Priority Interrupt 
KA15 Automatic Priority Interrupt 
CR03B/CR15/CR116 Card Reader 
Core Memory 16-Bit (12K) 6 

Core Memory 18-Bit (MM15/MK15/ME15/MF15) (32K to 128K) 8 

TC15 4-TU56 or TC02/8 TU55 DECtape 

RF15 8-RS09 Disk 

KK15 8-RK05 Disk Cartridge^ 

RP15 8-RP02 RPO 3 Disk Pack 1 

FP15 Floating Point Processor 

VT15 1-VT04 or VT07 Graphics Display 

LP15/LP11/LS11/LV11 9 * * Line Printer 

TC59 8-TU10/TU20/TU30 Magtape 

XY11/XY3116 Plotter 

VP15A Storage Scope 

KSR33/KSR35/ASR35/LA30C/LA36/VT05/LK35 2 *7,12 Terminal 
VW01 Writing Tablet 


NOTES : 


1. The RPO 3 Disk Pack is supported as if it were an RP02 Disk Pack. 

2. The LA36 and LA30C DECwriters and the VT05 Video Terminal are 
supported up to 300 baud. 

3. API is required if the user has more than four PDP-11 options 
which need to interrupt the PDP-15. 

4. The older style of DECtape can be used: TC02 Control with 2 TU55 

single DECtape transports. 

5. The RK15 includes within it an 8,196-word UNICHANNEL-15 peripheral 
processor. If the spooling software is to be used, the require- 
ment for 16-bit core memory is raised from 8,192 to 12,288 words, 
if more than two devices are to be spooled. 

6. Prerequisite hardware for CR11 , LP11, LS11, LV11, XY11, and XY311, 
plus 16-bit core memory, is the RK15. The R&15 minimally contains 
a UNICHANNEL-15 with 8K words of 16-bit memory, sen RKllE Cartridge 
Disk Control and 1 RK05 Cartridge Disk Drive. At any given time, 
only one line printer, one card reader, and one XY plotter in the 
combined XVM/PDP-11 or PDP-15/PDP-11 system is supported by the 
software. The LS11 or LV11 printer must be connected to the same 
vectors/priority as would the LP11. 

7. The LK35 Graphic Keyboard is not a substitute for the console 

terminal; consequently, it also requires an LT15A Single Tele- 

type 1 Control. The paper tape facility on AS-R Teletypes is not 


teletype is a registered trademark of the Teletype Corporation. 
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software supported. The LA30C and LA36 DECwriters and the VT05 
Video Terminal can be run up to a baud rate of 300. 

8. Memory configuration greater than 32K require the XM-15 options 
and can utilize ME15 or MF15 memory only. 

9. The Card Reader and Line Printer requirements are waivered for 
those users not desiring BOSS XVM operation. 

10. The XM15 hardware option is not compatible with MM- 15 memory, 
KA-15 automatic priority interrupt and KM/KT-15 memory 
protect and relocate. The XM15 hardware functionally re- 
places these options. 

11. The KW15 real-time clock is recommended for NON-UC15 systems and 
is required for UC15 systems. 

12. The LA36 is supported as an 80 column, upper case only terminal. 


1.2.2. 1 UNICHANNEL-15 Hardware - The UC15 System, in its standard 
configuration, consists of the following equipment: 

PDP-11 computer 
DR15-C Device Interface 
Two DRll-C Device Interfaces 
Memory Multiplexer 

Local memory - up to 12,288 16-bit words of core memory 


NOTE 

The PDP-11, which functions as the programmable 
controller, can itself only process 16-bit words 
but controls peripherals that can process 18-bit 
words to provide compatibility with the XVM. 

The DR15-C and the two DRll-C Device Interfaces provide a communica- 
tion facility between the XVM and the PDP-11. In the normal mode of 
operation the XVM interrupts the PDP-11 to send to it commands and 
data. The PDP-11 processes the commands, accepts the data, and when 
done, interrupts the XVM to indicate job completion and possible error 
conditions . 

The Memory Multiplexer functions as a memory bus switch to allow 
either the XVM or the PDP-11 to communicate with the common memory. 


The following illustration shows the UC15 hardware configuration. 
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L 1 "J i v*- 1 1 

r -i_ Cj u. j_ g x — -l 

Unichannel-l 5 Hardware 


1.2. 2. 2 CTRL X Feature - The control X feature is available to the user 
whose system configuration includes a Graphics Processor subsystem. 

This feature gives the capability of changing from the hard copy out- 
put of the teleprinter to the soft copy output of the VT15 Display. 


1.2. 2. 3 Real-Time Clock - The Real-Time Clock runs continuously in 
order to update an elapsed time register. It can be used to time jobs 
or to control program execution. 

In addition to the above, the user may adapt the system to incorporate 
many other specialized peripherals, such as X-Y plotter, data acquisi- 
tion equipment, etc. 


1.2.3 The System Device 


The system device for DOS may be the RF15 DECdisk, the RK15 Disk 
Cartridge, the RP02 Disk Pack, or RP03 (supported as an RP02). 

The RF15 DECdisk equipment is composed of up to eight fixed-head, 
rotating disks which are treated by DOS as one contiguous storage 
area. The DOS Monitor provides for simultaneous use of the DECdisk 
or Disk Cartridge or Disk Pack as a system device, file device, and 
scratch device. 


1.3 SYSTEM SOFTWARE 


The XVM Disk Operating System's service routines perform four primary 
tasks for all user applications (see Figure 1-2) . 
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Figure 1-2 

XVM Monitor Disk Operating System Software 


rur UC15 systems only. 
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1. Program Preparation and Maintenance - There are system pro- 
grams to aid user program preparation by preparing file text 
for source programs and programs to aid testing and mainte- 
nance of object programs. 

2. Language Assembly and Compilation - Programs are available to 
translate problem-oriented and procedure oriented languages 
into machine language and to incorporate routines into com- 
plete, executable programs. 

3. Run-Time Aids - External routines from several libraries are 
available to the user. The libraries may contain either user- 
designed routines or those provided by DOS which can be im- 
plicitly called. 

4. Utilities - DOS provides facilities for efficient storage, 
flow, and retrieval of system and user data. There are also 
system programs that provide file verification and data buf- 
fer allocation, file data manipulation, etc. 

The system software lets the user deal with many complex problems in 
a simple and straightforward manner. The system will allow the user 
to perform all of these functions: 

1. Write programs in four higher-level languages - FORTRAN IV, 
FOCAL, MACH 1 and MACRO. 

2. Edit and debug programs prior to run. 

3. Load and link programs. 


Run 

programs by: 


a. 

handling I/O, 


b. 

reading and writing named 

random-access files on disk 


storage. 


c . 

providing run-time device 

independence , 

d. 

chaining long programs . 



5. Batch processing from paper tape or cards, or a mass 
storage file. 

6. Support full spooling of multiple devices on the UNIBUS. 


'For UC15 systems 


only. 
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Listed in Table 1-1 are individual system programs in the XVM Disk 
Operating System. 


Table 1-1 

DOS System Software 


System Functions 

Program Name 

Description 

MONITORS 

BOSS Monitor 

A stand alone batch processing 
software system. See the BOSS 
XVM User’s Manual. 


DOS Monitor 

Allows system parameter changes 
and device assignments. 


PIREX 1 

A multi-tasking, multi- 
programming executive that runs 
in the PDP-11 local memory. 

LANGUAGES 

FORTRAN IV 

Compiler, Object Time System, 
Science Library. 


FOCAL 

An on-line interactive alge- 
braic language. 


MACRO 

A symbolic XVM assembler 
language . 


MACH 1 

A symbolic PDP-11 assembler 
language . 

PREPARATION AND 
DEBUGGING 

DDT 

A Dynamic Debugging Technique 
for FORTRAN and MACRO pro- 
grams . 


DUMP 

The capability to output speci- 
fied core locations. 


EDIT 

Text Editor providing inser- 
tion, deletion, and modifica- 
tion of symbolic text. 


EDITVP & EDITVT 

Special versions of EDIT which 
provide fast soft copy edit- 
ing on the VT or VP display 
system. 

UTILITIES 

General 

PIP 

Facilitates the manipulation 
and transfer of a data file 
from any input to any output 
device . 


UPDATE 

Binary program retrieval and 
library update program. 


SRCCOM 

Source compare program. 


t_ 

x For UC15 system only. 
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Table 1-1 (Cont) 
DOS System Software 


System Functions 

Program Name 

Description 


MTDUMP 

Magnetic Tape DUMP program. 


8 TRAN 

Translates PDP-8 source code 
into XVM code . 

UTILITIES 



System 

SGEN 

Provides the ability to tailor 
the system structure to a 
particular hardware/software 
configuration . 


PATCH 

Makes corrections to systems 
programs on the systems de- 
vice, and adds programs to the 
system. 


MCLOAD 1 

Installs MACH paper tapes on 
the system disk. 


SPLGEN 1 

Creates spooling areas on RK 
disk cartridges. 


SPLOAD 1 

Installs SPOLll paper tapes on 
the system disk. 


SPOOL 1 

Permits automatic temporary 
storage of low speed data on 
a high speed storage device. 

OPERATING PROGRAMS 

Linking Loader 

Loads relocatable programs and 
required routines. 


CHAIN & 

Multiple segmentation of large 


EXECUTE 

programs and overlays to allow 
economy of core. 


These programs are supervised by the Monitor to form an interactive 
collection of service programs. This relationship is illustrated in 
Figure 1-3. 

1.3.1 How DOS is Supplied 


The media on which the XVM/DOS system is supplied and the steps neces- 
sary to build the initial system are described in the XVM/DOS VIA 
System Installation Guide. 

1.4 OPTIONAL SOFTWARE 


The software packages, described below, are optionally purchased by 
the XVM/DOS User. 

^Unichannel-15 systems only. 
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1.4.1 DECsystem-10/XVM Communications Link 

The DECsystem 10 to XVM Communications Link software provides support 
for a single hardwired, error correcting, asynchronous data link be- 
tween a UNICHANNEL system and a DECsystem-10 . The communications 
link is a low speed (2400 baud or less) data link for the users of 
XVM/DOS the DECsystem-10 . 

1.4.2 LV11 Electrostatic Printer/Plotter Raster Scan Package 

A library of modules allows the user to 'snapshot' a VT-15 display 
image onto the LV11 Electrostatic Printer/Plotter. An intermediary 
in this process is a disk file of a standardized graphics format. 

A user without a VT15, wishing to use the LV plot capability, may call 
the VTl 5 graphics routines without starting the VT15 scope, or he may 
write data in the format of the intermediary disk file. 
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OPERATING PROCEDURES 


10.1 INTRODUCTION 

This chapter provides general operating procedures and considerations 
to assist novice users in operating in the XVM/DOS Monitor environment. 
Procedures for system startup and system generation are the subject of 
Chapter 7 and are not included here. The discussions and examples in 
this chapter assume a properly configured and running system. It is 
assumed that the reader is familiar with the keyboard commands, as de- 
fined in Chapter 8. Further, the user should be aware of the different 
types of I/O device handlers and their versions, as described in 
Chapter 9, and in particular, the tables which list those handlers 
which can be used with the XVM/DOS System programs. 

Specific operating procedures for the system programs (i.e., command 
strings, options, functions, error messages, and so on) are provided 
in the various language and utility program manuals listed in the Pre- 
face. Once a user gains some understanding of the use of the system 
programs and their commands from these manuals, he will find that the 
XVM/DOS Keyboard Command Guide provides most of the information normally 
required for day-to-day user reference. 

Since most procedures involved with keyboard operation are specific 
to particular programs, very little will be said here about them. 

In general, keyboard operations at the Monitor level consist of issuing 
commands to set up system operation, prior to calling system and user 
programs. This usually involves at least the LOGIN and LOGOUT com- 
mands, and quite often requires the PIP program, as well. 

This chapter consists primarily of two large examples of what might be 
typical XVM/DOS operations. Each example is the result of an actual 
session at the XVM. On the left side of each page of the examples is 
the actual teleprinter output. All commands typed by the user are 
underlined. On the right is a running commentary on all significant 
teleprinter lines. 
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10.2 EXAMPLE OF KEYBOARD OPERATIONS 

Figure 10-1, Example of XVM/DOS Keyboard Operating Procedures, demon- 
strates some typical keyboard procedures. The example consists of a 
series of operations in which a simple FORTRAN program is transferred 
to the disk from DECtape, edited, compiled, run, and transferred back 
to DECtape. Figure 10-2 shows the program. The program simply prints 
the numbers 1 through 10 on the device associated with .DAT slot 4, and 
then returns control to the Monitor. 

10.3 EXAMPLE OF OPERATING PROCEDURES USING COMMAND BATCHING MODE 

The example which is contained in Figure 10-3 demonstrates typical 
operations using the Monitor's Command Batching Facility. Essen- 
tially the same types of operations which can be performed at the key- 
board can be accomplished using Command Batching Mode. There are, of 
course, some operations which, although legal, are more difficult to 
accomplish, such as editing. To prepare a job for Command Batching 
Mode, the Programmer creates a file of keyboard commands in the se- 
quence in which they would normally be issued from the teleprinter, 
interspersed with the special batching commands described in paragraph 
8.12 (as applicable). The file can exist on DECtape, magtape or 
disks, or either on punched cards or paper tape. The programmer then 
submits the batch file and other required data (DECtapes, Magtapes, 
etc. for use during the job run) to the computer operator for execu- 
tion along with appropriate instructions. Users who prepare batching 
files on punched cards should remember to place an end-of-file card 
at the end of the card deck. This card is created by multiple punch- 
ing all punch positions in card column 1 (see 9. 3. 8.1 d) . 

Example 10-3 is basically similar to that in Figure 10-1 except that 
no editing is performed since it is more easily and accurately ac- 
complished by the programmer directly. Similarly, requests for de- 
vice assignments were also omitted since this information cannot be 
utilized at runtime in a batching environment. 
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The user types CTRL C to prepare 
the Monitor for keyboard command 
input. If no response, the Monitor 
must be reinitialized using the 
bootstrap — see Chapter 7 . 


XVM/DOS Vnxnnn If the Monitor requests a date (in 

tr vrf dicating it has just been started 

ri^F 1^/09/75 via the bootstrap) enter it as re- 

quired. Otherwise check the date 
(type to make sure it is cur- 

rent and correct it if it is not. 


If the user wishes to use disk 
storage, he must log-in to the 
Monitor with a UIC of his creation. 


At this point, the user might con- 
sider typing other commands such 
as: VT ON, KEEP ON, PROTECT etc. 

(refer to Chapter 8) . 


B h N K M 0 .u c. 


Call PIP 


PIP XVM Vnxnnn 



1ST FCL :L 18- NOV-75 

>T SV-.DT1 FT NT ST SRC 


Request a User File Directory 
listing to see if there is enough 
space available for the operations 
to be performed. (Since there 
are 1641 blocks indicated, the 
user can continue. If enough 
space were not available, however, 
other files in the UFD would have 
to be deleted.) 


If the user had no previous UFD 
on the disk, he would create one 
using the PIP command. 

Nu-iDK-^ 

Transfer program (FTNTST SRC) 
from user's DECtape to disk. 


Figure 10-1 

Example of XVM/DOS Keyboard Operating Procedures 
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X V M / B 0 S V n x n n n 
$ R Eli IT ^ 


♦ DAT 

1 b 

. 1. 3 

- :i. o 


DEVI Cl 

■ UIC 

USE 

b T A 

G A R 

OUTPUT/SCRATCH 

SYA 

GAR 

I/O 

SYA 

gar 

S E C 0 N D A R Y 0 U T P U T 

LPA 

GAR 

LISTING 

CM A 

GAR 

SECONDARY INPUT 


iemtJ 


E D I T 0 R X V H V n x n n n 
> OPEN FTNTST ^/ 

EBIT 

>P 

C 

EXAMPLE - SAMPLE FOE' TRAN TEST PROGRAM 


>1^ 

> N 2 +J 

>£V 

EXAMPLE •••• SAMPLE FORTRAN TEST PROGRAM 
>CjVC/J 

c EXAMPLE -• SAMPLE FORTRAN TEST PROGRAM 

> CLOSE ^ 


EDI T 0 R X 0 M V n x n n n 

>ZC^ 

X V M / Ii 0 S V n x n n n 

IRRj 


DAT 

DEVICE 

UIC 

USE 

•13 

SYA 

GAR 

OUTPUT 

■12 

LPA 

GAR 

LISTING 

1 1 

SYA 

G A E 

INPUT 

A TT - 





Figure 10-1 (Cont.) 

Example of XVM/nOS pvhna r-/^ ti j 

~ -i ^ L.i.iy nu^cuuies 
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$F4^ 

FPF4M XMM yiAQOO 
>BL-FTNTST^ 


END PASS! 

PAGE 001 FIN 1ST SRC 09-DEC- 75 00 i 20 FPF4M XVM V1A000 


0001 

0002 

C 

C 

EXAMPLE - SAMPLE FORTRAN TEST PROGRAM 

0003 

0004 

C 

DO 1 1=1? 10 

0005 

1 

WRITE (4? 100) I 

0006 

100 

FORMAT < 6X ? 13) 

0007 


STOP 12345 

0008 


END 

PROGRAM 

SIZE = 

00050? NO ERRORS 

PROGRAM 

SIZE - 

00050? NO ERRORS 

FPF4M XMM V 1 A 000 

>2C^7 



XVM/DOS 

V1A000 


$R USER 


* DAT 

DEVICE 

UIC 

■M 

SYA 

GAR 

+ 2 

SYA 

GAR 

+ 3 

SYA 

GAR 

+ 4 

IT A 

GAR 

•15 

PR A 

G A R 

$ A I T 4^7 



$ GL PAD 


BLOADER XVM 01 AO 00 
>-FTNTST 


4 

5 

6 


8 

9 

10 


X V M / D 0 S 0 1 A 0 0 0 


Figure 10-1 (Cont.) 

Example of XVM/DOS Keyboard Operating Procedures 
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4£IF>^ 

PIP XVri VIA 000 
> T DT1-.SY FIN 1ST SRC ^ 
I0PS4 DTAJ. ""'R 


>L T T....SY 


09 

-DEC™' 

? 





i.i J. K i::. L i 

ORY L 

1. S 1 

.1. NO 

< Oaf 



.1. c'> -c) / 

FREE 

BL 

KS 




1 4 

USER 

FI 

LES 




237 

USER 

BL 

KS 




EXBD 

005 


46 

31. 

■OCT 

•75 

FT NT ST 

BIN 


:l. 

09 

•DEC 

.. ”7 r: ] 

EXBD 

BIN 


:l. :i. 

31. 

•OCT 

/ o 

FOCAL 

BIN 


35 

14 

■NOV 

■75 

FNELJ 

BIN 



1. 4 

•NOV 

•75 

r 1... IBNF 

BIN 


1 1 1 

14 

NOV 

-75 

FT NT ST 

SRC 


1 

09 

•DEC 

■ 7 5 

DS K 

BAT 


2 

21 

OCT 

• 7 5 

CH3 

ECL 


1 

18 

NOV 

•75 

CHI 

FCL 


1. 

1 8 

NOV 

•75 

CH2 

FCI... 


:!. 

1 8 

NOV 

. y 

TST 

FCL 


1 

18 

NOV 

•75 

•D SY F 

TNT ST 

SR 

c 




■"”C 







V H / D 0 S 

0,1. A 000 





LOGOUT 

J 







Figure 10-1 (Cont.) 

Example of XVM/DOS Keyboard Operating Procedures 


0 0 0 2 

0 0 0 3 
0 0 0 4 
0 0 0 5 
0 0 0 6 


100 




D 0 i 1 :::: 1 p 1 o 
WRITE ( 4 ? 1 0 0 > I 
FORMAT < 6X v 13) 


Figure 10-2 

Listing of Sample FORTRAN Program 
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X v H /" D 0 S V n x n n n 
X U M / D 0 3 V n x n n n 

$ $ ,.J 0 B T E 0 i C 0 n M A N D B A ! 0 H 1 N G M U U 
$ LOG IN GAR 
X V M / D 0 S V n x n n n 


BANK MODE: 




' U !.. 


(jN 


$LOG 

PLEASE MOUNT DEC f APE 
CONI A I N I NG :: IN I ST Si A': ■' ON 
BE Cl APE UNIT 1 AN l b I 10 
WRITE ENABLE * 

THANKS ! 

$$ PAUSE 


r i. r 

PIP XVM Vnxnnn 
> T S Y .... B T i FTNTST SRC 


XU H/ DOS Unxnnn 

$$ JOB 
$ A TT - :l. 2 


$• F 4 

FPF4H XVM Unxnnn 


> Bi '"T^T ST 


j|r j\i n p a, 3 3 ;j 


PAGE 001 

FTNTST SRC 09-l.E 

0 0 0 1 c 

0002 C 

EXAMPLE ■••• SAMPLE 

0003 G 


0004 

DO 1 I -It 10 

0005 1 

[4 H I 1 1::. ( 4 v 1 0 0 ) .1. 

0006 100 

FORMAT C 6X * 13 > 

0007 

STOP .12345 

0008 

END 

PROGRAM SIZE 
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Figure 10-3 (Cont.) 

Example of Command Batching Mode 

10.4 ERROR DETECTION AND RECOVERY PROCEDURES 

All major components of the XVM/DOS Software System contains facilities 
for error detection and operator notification. This includes the 
System Programs, I/O Device Handling Routines and the Monitor itself. 
The operator is notified of the existence of an error condition most 
generally by a message output to the console teleprinter. There are, 
however, two situations in which the operator would not receive a 
message on the teleprinter. The first is the normal occurrence of 
end-of-file, end-of-medium, parity and checksum error conditions by 
means of the information fields provided in header word 0 of the 
affected logical record. Recovery from these errors is not discussed 
here, since it is the user's program which must recognize these 
conditions and determine the appropriate corrective action. (Refer 
to paragraph 6. 3. 1.1.) The second situation is the occurrence 
of an undetectable error such as a user's program looping endlessly. 
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Under these conditions, the user can detect the error condition by ob- 
serving that the program is not operating as expected. His recourse 
in this case is to abort the operation by typing CTRL C or CTRL Q. 

There are two types of error messages output to the console teleprinter 

• I/O errors which are detected by the I/O device handlers and 
printed through the Monitor's error message facility. These 
messages, referred to as "IOPS errors", consist of the mne- 
monic "IOPS" or "IOPSUC" followed by a number. 

• System Program and Monitor detected errors which generally 
result from syntactically incorrect or illogical command 
strings or other illegal operating conditions. These messages 
are generally self-explanatory and consist of an appropriate 
symbol, word, phrase or sentence. 

The degree to which IOPS error recovery is possible can vary with the 
nature of the error. In some situations, it may be possible to con- 
tinue the operation from the point where it was interrupted by the 
error message. For example, the I0PS4 message (I/O Device Not Ready) 
occurs when an I/O device hardware not ready condition is detected by 
the handler. To recover, all that is required is that the operator 
correct the condition (e.g., card reader out of cards) and type CTRL R. 
In other situations the operator may have to retype a command string 
correctly, restart the interrupted program (CTRL P) or call in the 
Monitor (CTRL C) to assign or reassign an I/O device or to reload the 
program. Some users may wish to save an image of core at the time of 
the error. In that case, the QDUMP command (see 8.7.2) would be typed 
before reloading the offending program. If, after typing CTRL C, the 
Monitor does not start up because a runaway program has destroyed the 
bootstrap, the bootstrap must be reinitialized or reloaded using proce- 
dures described in Chapter 7. In UC15 systems, when an I0PS4 condition 
arises on UNICHANNEL devices, the operation continues automatically 
once the condition is corrected, except for the RK05 where CTRL R must 
be typed . 

Complete identification, explanation and recovery information for IOPS 
errors is provided in Appendix D and for IOPSUC errors in Appendix J. 
Similar information for other error messages is found in the applicable 
language or utility program manual for the applicable System Program. 
The XVM/DOS Keyboard Command Guide provides complete command summaries 
of all XVM/DOS System Program and IOPS error messages. 
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CHAPTER 2 
SYSTEM PROGRAMS 


This chapter gives a brief description of the function of each major 
program in the system. Each system program will assist the user in 
performing a particular task in the process of application design and 
implementation. Considerations for system modification are reserved 
for the XVM/DOS System Manual and the UNICHANNEL XVM Software Manual . 

2.2 CHOICE OF LANGUAGES 

User source programs can be implemented at several levels depending on 
those particular system features required for a given processing environ- 
ment. DOS supports three levels of automation for object program pre- 
paration: 

1. Compiler level language - FORTRAN IV 

2. Assembly language - MACRO/MAC 11^ 

3 . Interpretive language - FOCAL 

2.2.1 FORTRAN IV Compiler 

The FORTRAN IV compiler is a higher-level, procedure-oriented language 
system that accepts statements written in the FORTRAN IV language and 
produces a relocatable object program capable of being loaded by the 
Linking Loader. XVM FORTRAN IV is based on the language of ANSI 
Standard FORTRAN (X3. 9-1966). The system is augmented by the Floating 
Point Processor, the FORTRAN IV compiler, and an Object Time System. 

Object time program capabilities include "floating point" instructions. 
Subroutines written in either FORTRAN IV or MACRO assembly language 
can be loaded with and called by FORTRAN IV main programs. Compre- 
hensive source language diagnostics are produced during compilation, 
and a symbol table is generated for use in on-line debugging with DDT. 
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The system's Data-Directed Input-Output package permits input or out- 
put of ASCII data without reference to a FORMAT statement. The system 
can also perform memory- to -memory transfers (ENCODE/DECODE) moving data 
from memory to the I/O Buffer to memory under FORMAT control. 

The two FORTRAN IV compilers supported by XVM/DOS are: (1) F4M and 

(2) FPF4M (Floating Point mode) . Each has its own Object Time System 
and Science Library so that program routines may utilize all system 
hardware and software features. 

A FORTRAN IV program may be compiled and run in several different 
equipment environments. The FORTRAN programmer need not be too con- 
cerned with the details of his environment since the FORTRAN Object- 
Time System (OTS) will ensure that his source statements generate the 
appropriate computer instructions. For example, an arithmetic statement 
such as A=A*B will appear the same in any FORTRAN IV program. In the 
object program it may be transformed to a subroutine call or a floating 
point instruction, depending on the hardware configuration on which 
the program is produced. FORTRAN data-transmission statements auto- 
matically call a number of OTS subroutines which serve as an inter- 
face between the user program and the Monitor. These routines may 
also be called from MACRO assembly language programs. Further, pro- 
grams written in FORTRAN IV can be linked to programs or routines 
written in the MACRO assembly language. 


For more information concerning this higher-level programming language, 
refer to the FORTRAN IV XVM Language Manual and the FORTRAN IV XVM 
Operating Environment Manual . 

2.2.2 MACRO XVM Assembler 

This MACRO Assembler provides users with macro generating and calling 
facilities within the context of a symbolic assembler. Some of the 
prominent features of MACRO include: 

1. The ability to: 

(a) define macros, 

(b) define macros within macros (nesting) , 

(c) redefine macros (in or out of macro definitions) , 

(d) call macros within macro definitions, 

(e) have macros call themselves (recursion) . 
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2. Conditional assembly based on the computational results of 
symbols or expressions. 

3. Repeat functions. 

4. Boolean manipulation. 

5. Optional octal, symbolic, and cross-reference listings. 

6. Two forms of radix control (octal, decimal) and two text 
modes (ASCII and 6-bit trimmed ASCII) . 

7. Global symbols for easy linking of separately assembled or 
compiled programs. 

8. Choice of output format: relocatable, absolute binary 

(checksummed) , or full binary — capable of being loaded via 
the hardware READIN switch. 

9. Ability to utilize user-designed input/output macros. 

10. A Table of Contents option containing the page numbers and 
text of all assembled .TITLE statements in the program. 

11. The ability to combine up to three input files for one 
assembly. 

MACRO permits the programmer to use mnemonic symbols to represent 
instruction operation codes, locations, and numeric quantities. It 
is essentially a comprehensive macro instruction generator. This 
generator permits easy handling of recursive instruction sequences, 
changing only the arguments. 

The assembler facilitates the development of instructions called 
"macros" which, when used as a source statement, can cause a specific 
sequence of instructions to be generated in the object program. Refer 
to the MACRO XVM Assembler Language Manual for a complete description 
of the language. 

The standard object code produced by MACRO is in a relocatable format 
which is acceptable to the Disk Operating System's Linking Loader 
utility program. Relocatable programs that are assembled separately 
and use identical global symbols where applicable, can be combined 
by the Linking Loader into an executable program. 


* 
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An output listing, showing both the programmer's source coding and the 
binary object program produced by MACRO, is printed if desired. 

This listing includes all the symbols used by the programmer with their 
assigned values. If assembly errors are detected, erroneous lines are 
marked with specific letter error codes. 

2.2.3 MACH Assembler^" 

The MAC 11 Assembler provides the user of the UNICHANNEL-15 system with 
the capability of assembling the full repertoire of the PDP-11 instruc- 
tion set. Besides making the UC15 system self-sufficient it provides 
the users with operating and calling facilities within the context of 
a symbolic assembler. Some notable features of MACH are: 

1. The ability to: 

(a) define macros, 

(b) define macros within macros (nesting) , 

(c) redefine macros (in or out of macro definition) 

(d) call macros within macro definitions 

(e) provide alternate exit points from macros (particularly 
nested macros) 

(f) pass arguments (numeric and non-numeric) and compute 
the number of arguments passed 

(g) provide a built-in error reporting capability in macros 

2. create automatic local labels 

3. concatenate strings 

4. generate indefinite and definite repeat blocks 

5. conditional assembly based on the computational results of 
symbols or expressions 

6. two forms of radix control (octal, decimal) and three text 
modes (ASCII, ASCIZ and 6 bit ASCII) 

7. ability to utilize user designed input/output macros 

8. use local and non-local labels 

9. provide a table of contents containing the page numbers, text 
of all assembled .TITLE statements in the program and the 
line numbers of an output listing. 
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MAC 11 permits the programmer to use mnemonic symbols to represent 
instruction operation codes, locations, and numeric quantities. It 
is essentially a comprehensive macro instruction generator. This 
generator permits easy handling of recursive instruction sequences, 
changing only the arguments . 

The assembler facilitates the development of instructions called 
macros" which, when used as a source statement, can cause a specific 
sequence of instructions to be generated in the object program. Refer 
to the MACH XVM Language Manual for a complete description of the 
language . 

The only object code produced by MAC 11 is in an absolute format on 
papertape. 

An output listing, showing both the programmer's source coding and the 
binary object program produced by MACH, is printed if desired. This 
listing includes all the symbols used by the programmer with their 
assigned values. If assembly errors are detected, erroneous lines are 
marked with specific letter error codes. 

2.2.4 FOCAL Interpreter 

FOCAL (Formulating On-Line Calculations in Algebraic Language) operates 
in on-line conversational mode, using natural language and arithmetic 
terms to establish a simplified environment for the computer-aided 
solution of business and scientific arithmetic problems. Included in 
FOCAL are such features as: 

1. Linkage to assembly language (MACRO) routines to establish a 
user library of commonly used functions. 

2. Use of COMMON to facilitate chaining in the same manner as 
FORTRAN IV. 

With FOCAL, the user can generate mathematical models, plot curves, 
solve sets of simultaneous equations in n-dimensional arrays, and do 
much more. Refer to the FOCAL XVM Language Manual for a complete de- 
scription of this program. 

FOCAL library commands allow the user to save and then call programs 
by name. These commands result in files consistent with the DOS file 
format. Such files can be manipulated by other DOS programs, such as 
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PIP and EDITOR. FOCAL has commands which allow the segmentation 
(chaining) of FOCAL programs. 

The ability to write FOCAL functions in MACRO assembly language and 
subsequently interface these functions with the FOCAL interpreter is 
an important feature. These functions are processed in the same way 
as the normal internal functions which DEC supplies with the inter- 
preter. 

2.3 SYSTEM GENERATOR (SGEN) 

The System Generator (SGEN) is a standard DOS Utility program used to 
modify disk resident system files. SGEN, which is available only to 
the system manager via MIC protection enables him to tailor his system 
to add to the supplied software in order to develop a resident soft- 
ware system unique to the installation or to his specific needs. The 
System Manager calls the system generator program via the Monitor 
command "SGEN". When SGEN is loaded, it initiates an interactive 
question/answer sequence regarding the following system functions and 
parameters : 

1. The size of the tQ area, 

2 . Hardware options , 

3. Type of printer unit used, 

4. Required device handler designations (i.e., the standard I/O 
configuration the user wants for the system programs) , 

5. Skip-Chain information - Priority Interrupt Skip Chain con- 
tents and order, 

6. Default assumptions, including: teleprinter characteristics, 

Bank or Page Mode, use of XVM mode, etc., 

7. System memory size, 

8. .DAT slot assignments, 

9. Monitor Identification Code to designate the privileged 
access by the System Manager, 

10. Default buffers that are needed at any time during a user 
program, 

11. Default Files Protection Code. 

Careful planning is necessary to ensure that the most efficient system 
will be developed for the user's particular needs. For more informa- 
tion, refer to the SGEN XVM Utility Manual . 
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2.4 PATCH UTILITY PROGRAM 

PATCH is used to: (1) make corrections to the binary version of many 

system programs on the system device, (2) examine and change any word 
in any disk or DECtape block, or (3) convert relocatable binary pro- 
grams into system programs. 

Facilities provide for: 

1. The selection, examination and alteration of registers within 
DOS System programs, and any data word block on mass storage, 
including the system information blocks, SYSBLK and COMBLK; 

2. The installation of suitable relocatable programs into a user 
system as non-relocatable System programs; 

3. The loading of absolute programs into a user system as System 
programs . 

The PATCH user must first be logged in under the Monitor Identification 
Code (MIC) to have access to system files. Binary programs which are 
not in system program format (e.g., relocatable link-loadable programs, 
and XCT programs which are executable files built by the System pro- 
gram CHAIN) cannot readily be corrected by using PATCH. 

With PATCH the user can: 

1. Select a system program to be patched. 

2. Select a single block to be patched. 

3. Obtain an octal printout of the contents of a particular 
location in a program. 

4. Alter the content of the listed location by simply typing the 
desired content in octal. 

5. Use the READ command to either replace or patch a system 
program. This enables the user to easily make corrected copy 
available for instant use without requiring reassembly, re- 
generation of a system or core patching. This is most useful 
for handling small updates or new versions of a program. 

6. Select and open specific word locations within SYSBLK or 
COMBLK. 

7. Select and examine registers within a system +Q area. 
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8. Automatically convert relocatable binary files into system 
program format and load the converted file onto the system 
device, provided disk space has been reserved by SGEN. This 
feature permits user programs to be called directly from the 
Monitor. It also enables the program to completely overlay 
its loader, to make the most effective use of core storage. 

For more information concerning this System Utility program, refer to 
the PATCH XVM Utility Manual . 

2.5 CHAIN AND EXECUTE PROGRAMS 

The programs CHAIN and EXECUTE allow the user to segment programs in 
order to construct and run a system of core overlays in an easy and 
straightforward manner. 

CHAIN reserves portions of user core (called COMMON blocks) from one 
segment to another so that the program segments can communicate. The 
FORTRAN IV compiler and the MACRO assembler can reserve COMMON blocks 
for future segmentation. This method of segmentation permits multiple 
overlays of executable code, constants, variables, arrays, and labeled 
COMMON blocks. 

Both system programs are required for segmentation: 

1. CHAIN - processes a version of the Linking Loader Code (Object 
Program code) allowing the user to build all the various seg- 
ments (or chains) of his program into an absolute executable 
(XCT) type file. 

2. EXECUTE - a control program which initiates loading of an 
executable file and transfers control from one chain segment 
to another. EXECUTE uses handlers with .TRAN and .FSTAT 
capabilities to improve initial and overlay loading per- 
formance. CHAIN organizes subroutines into units called 
LINKS, which may overlay each other. Several LINKS may over- 
lay a larger LINK without overlaying each other. A LINK is 
loaded into core when a subroutine within the LINK is called 
and remains resident until overlayed. A LINK'S core image 

is not recorded or "swapped out" when it is overlayed. The 
same image is brought into core each time a LINK is loaded. 

For maximum run-time efficiency, segments must be processed 
serially. See the CHAIN XVM/EXECUTE XVM UTILITY Manual for 
detailed instructions. 
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2.5.1 Advantages/Disadvantages of CHAIN & EXECUTE 
Advantages 


1. CHAIN 

a. Can build an operable program whose core requirement is 
larger than that of the run-time machine; 

b. Can be used to create elaborate overlay structures; 

c. Allows the user to request a detailed load map; 

2 . EXECUTE 

a. Its loader is more core efficient than the Linking Loader 
since Linking Loader code is processed only once; 

b. It is smaller at load time than the Linking Loader; 

c. The response time for loading and starting a user pro- 
gram is faster with EXECUTE then with the Linking Loader. 


Disadvantages 


1. One additional step is required to process Object Code in pre- 
paration for run-time. 

2. DDT (Dynamic Debugging Technique) cannot be used. 

3. At run-time, the execution of a segmented file requires a 
certain amount of processing overhead. 

2 . 6 LINKING LOADER 

The Linking Loader loads any FORTRAN IV or MACRO object program which 
exists in relocatable format. Its tasks include relocation of pro- 
grams, loading of called external subroutines, retrieval and loading 
of implied subroutines, and building and relocation of the necessary 
symbol tables. See the Linking Loader XVM Utility Manual for detailed 
instructions . 
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The loader first loads all the named programs included in the keyboard 
command string. It then additionally loads and links all requested 
library subprograms. The handlers are loaded from the device handler 
directory (IOS) , the requested library subprograms are loaded from the 
user library, if one exists, and the system library (found in BNK or 
PAG) . In addition, the loader can type out a core map which specifies 
the name and address of each program, subprogram, library routine, 
.GLOBL and common block loaded. 

2.7 DYNAMIC DEBUGGING TECHNIQUE (DDT) PROGRAM 

DDT provides on-line debugging facilities that enable the user to load 
and operate his program in a real-time environment while maintaining 
strict control over each program section. DDT allows the operator to 
insert and delete breakpoints, examine and change registers, patch 
programs, and search for specific constants or word formats. 

A breakpoint halts operation when the program flow arrives at the 
designated location. The DDT breakpoint feature allows the insertion 
and simultaneous use of up to four breakpoints. The search facility 
allows the operator to specify a search through any part or all of an 
object program with a printout of all locations whose contents are 
equal (or unequal) to a specified value. This search feature also 
works for portions of words, as modified by a mask. With DDT, regis- 
ters may be examined and modified in either instruction format or 
octal code, and addresses may be specified in symbolic relative, octal 
relative, or octal absolute. Patches may be inserted in either MACRO 
source language or octal. For more information, refer to the DDT XVM 
Utility Manual. 

2 . 8 DUMP PROGRAM 


DUMP gives the user the ability to output, on any device specified, 
core locations that have been preserved on disk via the CTRL Q (tQ) 
Monitor command. It also provides the ability to dump DECtape or disk 
blocks onto any device. For more information refer to the XVM/DOS 
Keyboard Command Guide. 
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2.9 MAGNETIC TAPE DUMP (MTDUMP) UTILITY PROGRAM 

The MTDUMP program provides the user who employs magnetic tape as a 
storage medium with the ability to view and manipulate any named por- 
tion (i.e., file) or specified record of a tape. 

Some of the features provided by MTDUMP are: 

a. Files may be output (dumped) onto any system device in any 
of four possible formats. 

b. Comments may be inserted into a DUMP file 

c. Files may be copied onto another tape. 

d. Magtape directories can be listed and cleared. 

e. Magtapes can be compared. 

For more information, refer to the MTDUMP XVM Utility Manual . 

2.10 TEXT EDITOR PROGRAMS, EDIT, EDITVP AND EDITVT 

The Text Editor provides the ability to read alphanumeric text from 
paper tape, Disk Cartridge, DECdisk, Disk Pack, DECtape, etc. 

The user can then examine and correct the text, writing it back on 
paper tape. Disk Cartridge, Disk Pack, DECdisk, and DECtape devices. 
Programmers can also use the Text Editor to create new symbolic pro- 
grams . 

The Editor operates on lines of symbolic text delimited by carriage 
return (CR) or ALT MODE characters. These lines can be read into a 
buffer, selectively examined, moved, deleted, or modified, and written 
out. New text may be substituted, inserted, or appended. 

The programs EDITVT and EDITVP are similar to EDIT except that they 
permit text to be displayed on the VT15 Graphic Display and VP15A 
(CRT) . Refer to the EDIT/EDITVP/EDITVT XVM Utility Manual . 

2.11 PERIPHERAL INTERCHANGE PROGRAM (PIP) 

With exceptions, PIP can transfer data files from any input device to 
any output device. It can be used to: 
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(1) refresh file directories of disk or DECtape, 

(2) list file directory contents of disk or DECtape, 

(3) delete, insert, segment, or combine files, 

(4) perform code conversions, 

(5) assign protection codes, 

(6) transfer files, or 

(7) copy the entire contents of disk and DECtape storage units. 
Refer to the PIP XVM Utility Manual . 

2.12 LIBRARY UPDATE PROGRAM 

The system program gives the user the capability to examine, extract, 
and update the binary library files on mass storage devices. For more 
information, refer to the UPDATE XVM Utility Manual . 

2.13 SOURCE COMPARE PROGRAM (SRCCOM) 

The SRCCOM program compares any two symbolic source programs (ASCII) 
and indicates their differences. This program is useful for program 
identification and/or verification, proofing an edited program, com- 
parison of old and new versions of the same program, etc. For more 
information, refer to the SRCCOM XVM Utility Manual . 

2.14 VT15 XVM GRAPHICS SOFTWARE 

The GRAPHIC15 (VT15) consists of system I/O device handlers and the 
graphics run-time system. The run-time system provides display file 
construction, interaction with light-pen and push-buttons, and storage 
and retrieval of display images. The run-time system can be LOAD'ed 
or CHAIN' ed with MACRO or FORTRAN applications programs. Display 
files can be constructed in memory above 32K. For further information 
refer to the VT15 XVM Graphics Software Manual . 

2.15 PDP-8 TO XVM TRANSLATOR ( 8TRAN) 

This program is used as an aid in translating programs written in the 
assembly languages of the Digital PDP-8 computer (PAL III, MACRO-8) 
into MACRO XVM form. The translator does not produce an executable 
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program, but translates a major portion of the PDP-8 code into equiv- 
alent MACRO XVM code and indicates those areas of the program which 
must be reviewed and processed by the programmer. For more informa- 
tion see the 8 TRAN XVM Utility Manual . 

2.16 VP15A GRAPHICS SOFTWARE 

The VP15A Graphics Software package consists of a group of routines 
which can be used with either FORTRAN IV or MACRO programs to operate 
the VP15A Storage Tube Display. Included in the package are an I/O 
device handler, text, point-plotting, and other routines, all described 
in the VP15A XVM Graphics Software Manual . 

2.17 SPOOLER DISK AREA GENERATION 1 (SPLGEN) 

SPLGEN allows the user to dynamically create or alter the RK disk area 
used by the UC15 spooler on any RK disk unit (0 through 7) . 

2.18 SPOOLER INSTALLATION PROGRAM 1 (SPLOAD) 

SPLOAD allows the user to install, on the system disk, the SPOL11 
paper tape produced by MACH. 

2.19 SPOOLER CONTROL PROGRAM 1 (SPOOL) 

SPOOL is used to initiate or terminate UNICHANNEL spooling using any 
RK disk unit which has been previously prepared for spooling by SPLGEN. 

2.20 BATCH OPERATING SOFTWARE SYSTEM (BOSS) 

BOSS is a dedicated (stand-alone) batch processing software system. 

BOSS is disk-resident with a set of programs supervised by the BOSS 
monitor. The monitor tailors the system configuration according to 
the BOSS command language cards, and then supervises operation of the 
system or user programs requested by control cards. BOSS has a unique 
and versatile job control language which can be modified by the user 
and tailored to his specific needs. For more information, see the 
BOSS XVM Users Manual. 
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2.21 MAC 11 INSTALLATION PROGRAM (MCLOAD) 

MCLOAD allows the user to install, on the system disk, the MACH paper 
tape produced during system installation. 
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CHAPTER 3 
SYSTEM CONCEPTS 

3.1 XVM/DOS MONITORING FUNCTIONS 1 

There are three sections to the DOS Monitor: (1) the Resident Monitor, 

(2) the Nonresident Monitor, and (3) the System Loader. For a UC15 
system, there is a fourth section, PIREX, that runs on the PDP-11. 

The Resident Monitor remains in core when system or user programs are 
running, and acts as the interface between the program and the system's 
facilities. PIREX is always core resident in the UC15 system. It 
acts as a communication link between the PDP-11 and the XVM in addition 
to performing other operations like spooling. (For more information 
refer to the XVM UNICHANNEL Software Manual . During program operation, 
the Resident Monitor has general control over the system. It functions 
to : 

1. Maintain orderly program flow, 

2. Handle teleprinter I/O, 

3. Act on Monitor service calls, 

4. Validate and transmit I/O calls to device handlers, 

5. Announce error diagnostics. 

The operator may alter the structure of the Resident Monitor via com- 
mands to the Nonresident Monitor. The Nonresident Monitor allows the 
operator to interrogate and alter many key parts of the system, in 
order to set up the system for the next program. It functions to 

1. Set I/O conditions by assigning physical devices to logical 
unit numbers, 

2. Supply system information, 

3. Save or restore core images, 

4. Load and Execute system and user programs, 

5. Change default system parameters. 

Normally, at the end of execution of a particular program, the oper- 
ator, the Batching Command String, or the program itself returns con- 
trol to the Nonresident Monitor. At that point, the operator or the 
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Batching Command String sets up the system for the next program and 
calls it in via commands to the Nonresident Monitor. 


The System Loader . SYSLD loads 

(a) all core-image system programs and all I/O handlers 
for those system programs, 

(b) the Linking Loader, and 

(c) EXECUTE 

In almost all cases, a change of program involves actions by the System 
Loader. The System Loader, however, is completely invisible to the user 
except for .SYSLD errors, such as insufficient core. 

The XVM/DOS Software System provides an interface between the system - 
or user-created program and the external world of I/O devices. This 
simplifies I/O programming. This interface is comprised of a function- 
ally related group of software called the .Input/Output Programming 
System, or simply IOPS. This is a conceptual term which encompasses 

(1) the I/O device handling routines within DOS, 

(2) a portion of the Monitor which is used in dispatching I/O 
commands to them, and 

(3) a Monitor routine for printing error messages. 

I/O device handlers are provided for all standard devices (see Chapter 
9) . These handlers relieve the user of the burden of I/O service, 
file management, overlapping I/O considerations and unwanted device 
dependence. I/O commands and data modes are standardized and are 
recognized by DOS device handlers. This facilitates device indepen- 
dence. For example, a non-directoried device handler such as for the 
paper tape reader will ignore (rather than declare an error) a com- 
mand to "seek a file" (which is required for directoried devices prior 
to issuing commands to read) . There are other features of the system 
which contribute to device independence; they are discussed in later 
paragraphs . 

3.1.1 System Communication Table (SCOM) 

The System Communication Table (SCOM) is a set of registers that are 
referenced by the Monitor, I/O device handlers, and other system pro- 
grams. It acts as a common parameter area for information required by 
both the System Loader and Monitor. The System Communication Table 
begins at absolute location 100 „ (Bank 0) . 

O 


3-2 



System Concepts 


The following list briefly outlines some of the SCOM table functions: 

Free Core Limits 

Hardware Option Availability 

System and User Program Start Addresses 

Handlers 

Interrupt Levels 

Number of Buffers Allocated 

Number of Words/Buffer 

Number of Entries in Mass Storage Busy Table 
User Identification Code 
Software Control Switches 
Date (MMDDYY) 

Time (HHMMSS) and other Clock Information 
Default Protection Code for Files 

A complete list of the SCOM table functions is given in the XVM/DOS 
System Manual . User programs may use SCOM locations following the 
conventions and techniques outlined in the XVM/DOS System Manual . 

3.1.2 Monitor/User Interaction 

The console teleprinter is the primary user-system interface for DOS 
program control. This control is implemented by commands to the Moni- 
tor, which accepts the three types described below: 

1. Commands which perform special services 

2. Commands which load system programs 

3 . Control character commands which provide system control while 
running user or system programs. 

NOTE 

In the context of this manual, the term 
"console keyboard" designates any one of 
several keyboard/printer/display I/O de- 
vices which could be used by the Monitor 
as the system command console device. 

The operator at the keyboard types commands to allocate system re- 
sources, load and start system and user programs, terminate program 
operation, and exchange information with the Monitor. Most of the 
Monitor's keyboard commands are issued prior to loading programs and 
are interpreted by the Nonresident Monitor, since it is not resident 
in core during system or user program execution. During program exe- 
cution, a small set of keyboard commands is available for general 


3-3 



System Concepts 


program control. These commands are interpreted by the teleprinter's 
I/O device handler (which is part of the resident portion of the Moni- 
tor) , and are used to control program start and restart, dumping of 
core, and the reloading of the Nonresident Monitor. Details on the 
DOS commands which can be issued from the console keyboard are de- 
scribed in Chapter 8 . 

The keyboard commands are, however, not strictly limited to input from 
the keyboard. The Monitor can be operated in a Command Batching Mode 
in which keyboard commands can be issued either from punched cards or 
paper tape or mass-storage files with minimum operator intervention. 
Similarly, the Monitor's responses to commands are not strictly 
limited to a keyboard device's printer or display, but may also be 
output to other devices including the VT15 Display or a line printer, 
when available. 

3.2 I/O COMMUNICATION 

The Monitor, by means of Device Handlers and Priority Interrupt (PI) 
or optional Automatic Priority Interrupt (API) , permits simultaneous 
operation of I/O devices along with overlapping computations. 

A system or user program initiates an I/O function by means of a Moni- 
tor command (system macro) , which is interpreted within the Monitor 
as a legitimate I/O call. The I/O call includes a logical I/O device 
number as one of its arguments. The Monitor establishes the logical/ 
physical I/O device association by means of a special table. When 
this has been accomplished, the Monitor passes control to the appro- 
priate device handler to initiate the I/O function, after which con- 
trol is returned to the system or user program. The system or user 
program retains control until an interrupt (PI or API) occurs; at this 
time the device handler takes control, in order to perform and/or com- 
plete the specified I/O function. The program may continue computa- 
tion or other processing while waiting for I/O completion. This fea- 
ture allows the programmer to make optimum use of available time. 

3.2.1 Device Independence 

In the DOS Monitor environment, the system manager may set up default 
device associations (correspondence between logical/physical devices) 
during system generation. Just prior to loading a system or user 
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program, a user may change these associations via the ASSIGN keyboard 
command. This capability adds true device independence to DOS. 

All device handlers are nonresident in the sense that only those 
handlers required by a program are loaded into core. 

3.2.2 I/O Device Handlers 

Users are spared the task of writing system software to handle input/ 
output to all standard system peripherals, since appropriate routines 
(Device Handlers) are supplied with the DOS Monitor. These routines 
process file and data level commands to the peripheral device. They 
generally perform the following functions: 

1. Drive I/O devices, 

2. Block Data Records for Devices, if necessary 

3. Manipulate files, 

4. Optimize device timing, 

5. Allocate/Deallocate Storage Space on the device, 

6. Request/Return core space. 

All communication between user programs and I/O device handlers is 
made via I/O Macros. The FORTRAN user need not be concerned with I/O 
Macros; they are generated by the FORTRAN Object Time System (OTS) 
routines which process the standard FORTRAN READ and WRITE statements 
at run time. Macros are covered in Chapters 5 and 6. 

There may be available in the system several handler versions for a 
particular device (e.g., DKA, DKB, DKC) . Each represents different 
compromises between core use and handler flexibility. Device handlers 
are covered in depth in Chapter 9 . 

3.2.3 Device Assignment Table (.DAT) 

The DOS Monitor contains a Device Assignment Table (.DAT), with an 
entry for each device used. Since the contents of the table can be 
altered by commands to the Monitor, actual I/O devices may be changed 
without altering the program references (logical device units) to these 
devices. Refer to Chapter 4 for more information concerning .DAT. 
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3.3 FILE STRUCTURES 

A file structure, as defined for DOS, is a method of recording, link- 
ing and cataloging data files. Each peripheral device has an asso- 
ciated file structure which governs the manner in which data are stored 

Card files and paper tape files are always organized as sequential 
files and both files and records are processed sequentially. A file 
or record in the middle of the medium can only be accessed after all 
preceding items have been processed. This is a restriction which is a 
consequence of the nature of the storage medium. In contrast, DOS 
provides direct access to files stored on DECtape or disk. The system 
maintains directories on these devices that point to each file on the 
device. Hence, such devices are called "directoried" or "file-oriented 
Both DECtape and magnetic tape (magtape) permit the user to operate 
either in a directoried or a non-directoried (sequential) mode. The 
system maintains a mini-directory for each file which points to each 
physical block in the file. 

The user of the XVM Disk Operating System is not required to pre- 
allocate file storage; the operating system provides the file storage 
space dynamically on demand. Not only is this convenient for the user 
because he does not have to worry about allocation when he is creating 
files, but it conserves storage by preventing large portions of storage 
from being unnecessarily tied up. More information on this topic can 
be found in Chapter 4. 

3.3.1 User File Directories and UIC's 


On DECtape, there is only one directory for the whole tape. On disk, 
there is a central directory, called the Master File Directory (MFD) , 
but each user can have his own User File Directory (UFD) . The MFD 
points to each UFD. Each UFD is named by a unique three character 
User Identification Code (UIC) . The User File Directory Table ( .UFDT) 
is part of the Resident Monitor associated with the Device Assignment 
Table. It indicates the User Identification Code (UIC) associated 
with every .DAT slot (i.e., each logical device). Disk I/O to a 
particular .DAT slot will go to files in the UFD named by the corre- 
sponding .UFDT slot. 
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The Monitor finds User File Directories by seeking associated User 
Identification Codes (UIC's), which are all listed in the Master File 
Directory. The UIC is necessary for all directory-oriented I/O to the 
disk. A programmer may identify himself (LOGIN) to the system with 
only one UIC at a time, but he may have as many UIC's as he wishes, 
provided each is unique and none is reserved^. Further, programs may 
simultaneously reference files under several different UIC's. 

3.3.2 Monitor Identification Code (MIC) 

A three-character Monitor Identification Code (MIC) is established at 
system generation time to provide privileged access by the System Man- 
ager. When the System Manager uses the MIC, all system and user files 
are open for reference or change. This code acts as a key to tempor- 
arily remove file protection. System generation, modification of 
system programs and listings of the entire disk directory are allowed 
only under the Monitor Identification Code. 

3.4 FILE PROTECTION 

DOS offers a simplified form of file protection. Each User File 
Directory has a protection code (optionally specified in commands to 
PIP) , and each file has a protection code (optionally specified in 
the .ENTER command or a command to PIP) . The protection codes are in 
effect only when a user tries to reference a file listed under a UIC 
other than the one currently logged into the system. If a User File 
Directory is protected, then the protection is provided for any file 
in the directory. For more information, refer to Chapter 6. 

The default protection code for the files is established at system 
generation time. Users may temporarily change the file default pro- 
tection code via the PROTECT command to the Monitor. (See Chapter 8.) 

3.5 I/O BUFFERS 

Two Monitor commands allow any handler or user program to call the 
Monitor to allocate and deallocate buffers. Each buffer is obtained 
from a "buffer pool" as needed. For more information, refer to 
Chapter 6 . 


"The LOGIN keyboard command is described in Chapter 8. 
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3.6 CHOICE OF EXECUTABLE FORM 

The object code usually produced by FORTRAN IV and MACRO is relocat- 
able binary which is made absolute by CHAIN, or loaded at run time by 
the Linking Loader. In addition to relocatable output, the MACRO user 
may specify non-relocatable types of output code. In a UC15 system, 
the user can produce absolute binary papertapes from MACH. No direct 
loading facility in the form of a loader is provided with it, (the user 
can write his own simple loader program) although PIREX has execution 
facilities. See the XVM UNICHANNEL Software Manual for details of 
PDP-11 program development. 

3.6.1 Relocatable Binary 

A relocatable object program may be loaded into any part of memory, 
regardless of which locations are assigned at assembly or compile 
time. To accomplish this, the address portion of some instructions 
must have a relocation constant added to it. This relocation constant 
is added during segmentation, by CHAIN, or at load time by the Linking 
Loader. It is equal to the difference between the actual memory loca- 
tion into which an instruction is loaded and the location that was 
assigned to it at assembly time. The language processors use codes to 
identify storage words as relocatable, absolute, or external. 

Relocatable Binary object programs may be loaded into and executed 
from any part of memory, regardless of the core locations assigned to 
the instructions by the language translator. The primary advantage 
of such a system is that it enables the user to easily write and load 
into core memory many programs (e.g., the main program and several 
subroutines) with no necessity for prior core mapping. Relocatable 
Binary is always produced by FORTRAN and is produced by MACRO when 
there are no .ABS or .FULL pseudo-ops. 

3.6.2 Absolute Binary Forms 

Absolute Binary object code is produced using the MACRO Assembler's 
•ABS, . ABSP , .FULL, or .FULLP pseudo-ops as described below. Programs 
assembled with these pseudo-ops are loaded and executed independently 
of the DOS System software. Refer to the MACRO XVM Assembler Language 
Manual for more information. MACH produces only an absolute format) . 
format (this format is different from the MACRO XVM absolute format) . 
Refer to the MACH XVM Assembler Language Manual. 
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3. 6. 2.1 .ABS and .ABSP Binary - The .ABS and .ABSP binary forms are 
checksummed binary coded programs or instructions assembled as .ABS 
(Absolute Binary) and assigned to occupy specific or absolute loca- 
tions in core memory. These programs can only be loaded into or exe- 
cuted from the locations assigned by the language translator. The 
task of placing multiple routines into core for execution becomes a 
tedious one. Absolute binary does have the advantage of a smaller 
loader, thus enabling the user to execute a larger program than is 
possible using relocatable binary. Ordinarily, the Assembler will 
precede the output with an Absolute Binary Loader which will load the 
punched output at object time. The loader is itself loaded via Hard- 
ware Read-in Mode. 

3. 6. 2. 2 .FULL and .FULLP Binary - The .FULL and .FULLP binary forms 
are unchecksummed binary consisting solely of 18-bit storage words. 
Programs assembled in this form are output on paper tape and are loaded 
via Hardware Read-in Mode. 

3 . 7 LOADER CONTROL 

As indicated in the previous section, CHAIN and the Linking Loader 
make relocatable object programs absolutely addressed. In addition, 
they join relocatable programs by supplying definitions for global 
symbols which are referenced in one program and defined in another. 

3.7.1 Globals 

The global feature is another of the programmer conveniences provided 
by the MACRO Assembler. It allows the user to provide a symbolic 
linkage between separately assembled programs including: a main pro- 

gram, subprograms, and general subroutines in system (Bank or Page) 
Libraries or User Libraries. 

In MACRO, the pseudo-op .GLOBL, followed by a list of symbols, is used 
to define to the Assembler two types of global symbols: 

1. Internal Globals - defined in the current program and refer- 
enced by other programs . 

2. External Symbols - referenced in the current program and de- 
fined in another program. Each external symbol will be used 
by the Linking Loader or CHAIN to store the actual address. 
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All references to external symbols should be indirect refer- 
ences, because memory banks may have to be crossed. 

The FORTRAN equivalents to external and internal .GLOBL's are CALL and 
SUBROUTINE. The Linking Loader and CHAIN use this information to re- 
locate and then link the programs to each other. 

3.7.2 Program Loading 

At program load time, the user, via appropriate keyboard commands, can 
select either Page or Bank Mode program loading and execution. Two 
versions of the Linking Loader and System Library are provided - one 
for each mode. 

3. 7. 2.1 XVM Mode - User programs may run in XVM mode which permits 
indirect addressing of memory beyond 32K. 

3. 7.2.2 Page Mode Operation - The DOS Monitor, when operating in 
Page mode, loads and relocates user programs in 4K pages and permits 
address modification via the index register (Index Addressing) . In 
Page Mode, the loader obtains library routines from the library in the 
PAG System file directory. 

3. 7. 2. 3 Bank Mode Operation - Running DOS in Bank mode permits direct 
addressing within 8K banks, but does not permit the use of the index 
register for address modification. All core-image system programs 
run in Bank Mode. In Bank Mode, the loader obtains library routines 
from the library in the BNK System file directory. 

3.8 ERROR DETECTION 

Comprehensive error checking and recovery are provided by the DOS 
Monitor, the loaders, and the I/O system as follows: 

a. DOS Monitor Errors - error conditions related to system de- 
vices, illegal device assignment, program name, and command 
references . 

b. IOPS Errors - all Input/Output device and data errors. 

c. Linking and System Loader Errors - memory overflow, input 
data errors, unresolved globals, and illegal .DAT Slot re- 
quests . 
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Detailed lists of errors that occur in the latter two categories can 
be found in Appendices D and E, respectively. 

The automatic core-dump commands QDUMP or CTRL Q will condition the 
Monitor to dump memory on the "save" or "CTRL Q" area of the system 
device, in the event of an unrecoverable error. 

Terminal errors are not reported to the user's operating programs; 
there are, however, a few I/O-detected errors that are reported to the 
user for program use, e.g. , parity, checksum, and buffer overflow 
errors are indicated in special control words of each IOPS data record 
(see Chapter 6) . Error detection and recovery are discussed in Chapter 
10 . 

After error messages are output, the user may optionally restart the 
program (CTRL P) , dump core (CTRL Q) , or return control to the Non- 
resident Monitor (CTRL C) . Other options are available to the user 
when errors occur; these will be discussed in succeeding chapters of 
this manual. 

3 . 9 INPUT/OUTPUT SPOOLING 

The UNICHANNEL-15 configurations allow spooling of tasks using PDP-11 
peripherals and memory. The actual spooling program (SPOL11) resides 
in PDP-11 (local) memory while a special interface program for the 
spooling function (SPOOL) resides in XVM (common) memory. Both of 
these spooling program modules are resident on the system disk. 

For further information regarding spooling, refer to the XVM 
UNICHANNEL Software Manual . 

The UNICHANNEL-15 system supports full, input spooling from the Card 
Reader (CR11) , and, output spooling to the Line Printer (LP11/LS11/ 

LV11 ) and plotter (XY11/XY311) utilizing any RK05 disk cartridge. 

The actual spooling program is resident in the PDP-11 (local) memory 
when spooling is enabled. It is dynamically connected or disconnected 
with PIREX at run time by SPOOL. 
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SPOOL determines if the spooler is running. If so, SPOOL asks "END?". 

If the reply is yes, a terminate spooling directive is sent to PIREX 
and the spooler is disabled. If the spooler is not running, SPOOL 
asks on which RK drive the user wishes to begin spooling. Spooling 
may be done on any RK unit that has a cartridge that has been initial- 
ized with a spooler area by the SPLGEN program. If the cartridge has 
a spooler area and if there is room in the PDP-11 local memory, the 
spooler is read from the system disk (DPO, DK, or RKO) and transferred 
to local PDP-11 memory and started. Note that the questions "RK UNIT #" 
and "BEGIN?" must be answered in this process. 

All questions have default replies displayed. These replies may be 
selected by entering a carriage return. The options on YES/NO ques- 
tions are "Y" or "N". The default value for the RK unit is the unit 
upon which spooling was done previously (or unit 0 if PIREX was just 
loaded) . 

Example : 

X V M / D 0 S U n x n n n 

$ SPOOL 

SPOOL XVM Vnxnnn 

rk unit # o 

BEGIN ? (Y) Y 

SPOOLING ENABLED 

X V ii / D 0 S 0 n x n n n 

$ SPOOL 


vnxnnn 


N D r ( Y ) Y 


X V H / D 0 S V n x n n n 


Appendix I lists the possible error messages and the conditions which 
cause them. 
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3.9.1 Output of Last SPOOLed Information 

UNICHANNEL users are advised to include the .CLOSE X statement if 
writing a MACRO program or an ENDFILE X statement if writing a FORTRAN 
program, where X is the .DAT slot assigned to the Line Printer/Plotter 
to ensure output of the last few records. In the absence of this 
statement, the last few records will be output only after the spooler 
internal buffer containing these records is full. 
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CHAPTER 4 
FILE STRUCTURES 


4 . 1 INTRODUCTION 

This chapter will define those concepts and facilities of the XVM/DOS 
system that are available for storage and retrieval of data from XVM 
mass-storage hardware/software systems, including DFCdisTc (RF) , Disk 
Pack (RP) Magtape (MT) , DECtape (DT) and Disk Cartridge (RK) . 

A large part of any programming task is accepting input and producing 
output. Therefore, it is necessary to understand the Input/Output pro- 
cess to take full advantage of the Disk Operating System's features. 

4.2 DEVICE ASSIGNMENTS 

As stated in the previous chapter, device assignment is managed through 
the Monitor's Device Assignment Table (.DAT). The .DAT associates log- 
ical device units with physical ones through "slot" numbers, which 
correspond to the logical device numbers . 

Device assignment slots are assignable via the Monitor ASSIGN command 
at run time. Refer to Section 8.5 of Chapter 8 for more information. 
Default assignments are defined during system generation (see SGEN XVM 
Utility Manual . Information in each program indicates which "slots" 
are required for that program. These slots are called the "active 
slots". The loaders use the information about active slots to bring in 
handlers for the devices named by the active slots. At run time, then 
each slot contains the physical device unit number (if any) and a 
pointer to the appropriate device handler, which was brought in by the 
loader. Without device assignment on a .DAT slot, a program's call to 
that slot will result in an I/O error — the slot will not point to a 
handler. Depending on the system generation, as many as sixty-three 
entries may be in the .DAT for program device assignment. 

Each I/O command under DOS references a .DAT slot. These commands pass 
control to the appropriate device handlers via a Monitor routine that 
uses the pointers in the .DAT. These device handlers are responsible 
for transferring data between the program and I/O devices. 
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They also initiate the physical reading or writing of files and per- 
form opening and closing of files and other functions peculiar to a 
given hardware device. Each slot then links the device-driving func- 
tions within a specified device handler to the program. The handlers 
all test for functions which they cannot service; for example, trying 
to rewind a card reader. Some functions are ignored; others are illegal 
and cause error messages to be output to the console teleprinter. All 
device handlers operate either with or without the Automatic Priority 
Interrupt (API) option. 

4.3 FILES 

A file is a collection of related records treated as a unit. In Inven- 
tory Control, for example, one line of an invoice forms an item, a 
complete invoice forms a record, and the complete set of such records 
forms a file. The word "file" is used in the general sense to mean 
any collection of information items similar to one another in pur- 
pose, form and content. "File" may also be generally applied to ex- 
ternal storage media such as papertape, punched cards, a Magtape, a 
DECtape, DECdisk platters. Disk Cartridge and a Disk Pack. 

4.3.1 Records 

In DOS, a record is a set of one or more related data words access- 
ible to the user as one item through .READ and .WRITE MACRO program 
statements or FORTRAN language statements. (Chapter 6 describes .READ 
and .WRITE) . The smallest addressable logical item within the file 
is this logical record. 

4.3.2 Words 


A word is the least addressable physical data unit. 


I/O Buffers are internal to, and must be defined by, each program. 

With the exception of certain block transfers, a buffer contains a 
single record. Under most of the Data Modes (described below) , the 
first two words in an I/O buffer (i.e., a record) provide system in- 
formation and cannot be used for data. This Header Word Pair within 
an I/O buffer is detailed in Chapter 6. On blocked devices (Disk and 
DECtape) , these header word pairs govern the physical structure with- 
in the file. Before output, the user must set up the Header Word Pair 
On input, the Header Word Pair arrives with Data Mode Information and 
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certain error indicators. The user is responsible for checking the 
various header parameters to determine if the data was read without 
error . 

4.3.3 Data Modes 

The Monitor allows data transmission to or from a system or user pro- 
gram in several different modes which structure internal data storage. 
Two modes, IOPS ASCII and IOPS Binary, offer the advantages of device 
independence. All handlers accept IOPS ASCII data, and most accept 
IOPS Binary. Three other data modes. Dump, Image Alphanumeric and 
Image Binary, allow the user to take advantage of device dependent 
characteristics. For more information, refer to Chapter 6. 

4 . 4 FILE STRUCTURES 

As stated in Chapter 3, a file structure is a method of recording, 
linking, and cataloging data files. File structuring, in general, is 
applicable to all I/O devices, including cards, paper tape, printers, 
keyboards, etc. In DOS, however, file structures are associated with 
Mass Storage devices only. A file structure dictates the file and 
record access methods. This organizational structuring is important 
because a file can be effective for a user application only if it is 
designated to meet specific requirements. A user must consider the 
following factors: 

SIZE - Growth of the file may require a change in file 

structure or data mode. 

ACTIVITY - The need to access many different records within 
a file (percentage of activity) or to frequently 
access the same records (an active file) will in- 
fluence information retrieval efficiency. This 
requires the user to select the right method for 
each job task. 

VOLATILITY - The number of additions and deletions to a file 

will affect the efficiency of the structures used. 

4.4.1 File and Data Access Techniques 

The usual technique for applications using Magtape is sequential ac- 
cess to the data file and sequential access of the data records. This 
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access is also characteristic of most uni-directional media, such as 
cards, paper tape, keyboards, printers, and displays. 

Another technique, which in DOS is applicable only to the disks, in- 
volves random-access (an alternate term is "direct-access") to a file 
and random-access of data records within the file. 

A third and intermediate technique, which is normally used on DECtape 
and on disk, employs random-access to a file and sequential access to 
the file's data records. The formal term is "random-sequential file 
structure", the informal term is "DECtape file structure". 

4.4.2 Sequential Access 

Sequential access is a storage retrieval technique in which a file and 
the records within it must be retrieved in the sequence in which they 
physically occur. Sequential access, when applied to the process of 
locating the beginning of a file or a data record within the file, 
means that the time required for such access is dependent on the neces- 
sity for waiting while non-desired records are processed in turn. 

1. Records can only be retrieved sequentially, beginning with 
the first record and accessing each subsequent record in 
turn. 

2. Direct retrieval is not possible, since no directory exists 
to the physical locations of the records, 

3. When adding or deleting a record, the system copies all the 
records preceding that record in the file, then performs the 
addition or deletion. The system then recopies all the re- 
maining records in the file. 

4.4.3 Direct Access 

Direct access to a file or to a data record within the file means that 
the time required for such access is independent of the location of 
the file or record relative to other files or records. 

Direct access should be considered as a valuable access method when 
retrieving selected records from random files; but it is not suited 
for sequential retrieval of records. The direct access technique makes 
it possible to process only the affected record during a file update. 
This reduces data sorting. 
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The main advantage of direct access processing is that it requires 
fewer processing steps. Along with its advantages, however, a direct 
access application requires special considerations by the system pro- 
grammer. Backup on a direct access system differs from backup on a 
tape system because the old record on a direct access device is de- 
stroyed when the updated record is written over it. 

4.5 MAGNETIC TAPE FILE STRUCTURE 


The DOS software provides for industry-compatible magnetic tape (Mag- 
tape) as either a directoried or a non-directoried medium. The mag- 
netic tape handlers communicate with a single Tape Control Unit with 
up to eight magnetic tape transports. 

When used as a non-directoried medium, there are a number of major dif- 
ferences between Magtape and other mass storage devices such as DECtape 
or Disk. Magtape is well suited for handling data records of variable 
length; such records, however, must be treated in serial fashion. The 
physical position of any record may be defined only in relation to the 
preceding record. 


When used as a directoried medium. Magtape assumes the external oper- 
ating characteristics of DECtape (described in 4.6). 


Sequential tape files are written one after the other, starting at the 
physical beginning of the tape. These files are separated from one 
another by End-of-File marks (hardware-detected) or by an End-of-Record 
line (software— detected) . (Refer to Figure 4—1, Sequential Data Access.) 
To read the N file on a tape, the user must first rewind to the begin- 
ning of the tape and then skip serially through N-l files to the de- 
sired file. Sequential tape files need not have a filename; only a 
known position relative to the files on the tape. 


Data records within a file are recorded in sequence. Sequential state- 
ments direct records to and from memory in the sequence in which they 
are physically on the device. To access the M th record within the N th 
file, the user first locates the beginning of the file (skipping N-l 
files) and then skips through M-l records. 


4-5 



File Structures 



Figure 4-1 

Sequential Data Access 


This sequential access method does not need a tape-resident directory 
to point to files. It is, therefore, called "non-directoried" in DOS. 
The non-directoried access method is generally applicable to unit- 
record peripheral devices. 

4.6 DECTAPE FILE STRUCTURE 

If magnetic tape transports could identify absolute positions on a 
tape, there would be no need to do sequential file access. The trans- 
port could search to a known location, and start processing. Then, 
an extra body of information (a directory) on the tape could point to 
each file. DECtape has this capability. 

In directoried mode, files are given unique names. The name and posi- 
tion of the beginning of a file are recorded in a directory. Direc- 
tories are at a fixed location (Block 100g) on the tape. DECtape direc- 
tories point to the first block of each file and each block points to 
the next. DECtape directories also maintain bit maps which indicate 
which tape blocks each file occupies and a map to show all occupied 
blocks on the tape. The file directory is fixed in size; consequently, 
the number of files that may be recorded is limited by the amount of 
storage available on the device (llOOg blocks) and/or by the number of 
file name slots in the directory (56 maximum) . 

File structures which employ a directory allow simpler and, in the long 
run, faster access to a file (the beginning of a file). See Figure 4-2. 
This is a distinct advantage over those devices which do not use a 
directory and must therefore rely on a file's position relative to 
other files in order to locate it. 
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Figure 4-2 

Directoried Data Access 

Programmers need not use the directory capabilities of DECtape. They 
can treat DECtape as magnetic tape by issuing magnetic tape I/O com- 
mands. Then no directory or identifying information of any kind is 
recorded or referenced on the tape and operation is similar to that 
of magnetic tape (described in 4.5). The DECtape handlers with their 
respective I/O functions allow the use of either of these modes. 

4.7 DISK FILE STRUCTURE 


The DOS disk file structure is in some ways analogous to DECtape file 
structure. Ordinarily, each disk user has a directory which points 
to named files, just as each DECtape has a directory. A single user's 
disk directory might correspond to a single DECtape directory. The 
DECtape, however, has only one directory, but the disk has as many 
directories as users have cared to establish. Whereas DECtape direc- 
tories may reference only a maximum of 56^ files, the number of files 
associated with any one directory on the disk is limited only by the 
available disk space. A single disk file's size is also limited by 
the available space, as is true with DECtape. 
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The DECtape directory is in a known location .. .at block 100 g . Since 
the disk may have a variable number of directories, the Monitor must 
know how to find each user's directory. It, therefore, maintains a 
Master File Directory (MFD) at a known location, and the Master File 
Directory points to each User File Directory (UFD) . DOS allows only 
those users who know a special code, called the Monitor Identification 
Code (MIC) , to have access to the MFD. Figure 4-3, Disk Data Access, 
illustrates the organization of the disk. 



Figure 4-3 
Disk Data Access 


4.7.1 User Identification Codes (UIC) 

The Monitor finds User File Directories by seeking associated User 
Identification Codes (UIC's) which are all listed in the Master File 
Directory. The UIC is a three-character code that is necessary for 
all directory-oriented I/O to the disk. A programmer may establish 
a new User File Directory by: 

1. Logging in his new UIC to the Monitor, 

2. Calling PIP, 

3. Issuing an "Nu_iDK-*^" command for RF15 DECdisk or "Nl_jDP^/" 
for RP15 Disk Pack or "Nl-jRK-^" for RK05 Cartridge Disk. 
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This establishes a new User File Directory, or refreshes (wipes clean) 
an old directory under that UIC. The "enter file" I/O command will 
also create a UFD, if none exists. 

4.7.2 The User File Directory Table ( . UFDT) 

The Monitor must have a way of knowing which User File Directory to 
reference when a program issues I/O commands to the disk. It makes 
the association between disk I/O commands and User File Directories 
by using a User File Directory Table (.UFDT). There are as many en- 
tries in the User File Directory Table as there are slots in the De- 
vice Assignment Table. Figure 4-4, Relationship Between the .DAT and 
the .UFDT, shows how the two compare. Disk I/O to a particular .DAT 
slot will affect files in the User File Directory names in the corre- 
sponding .UFDT slot. Programmers may modify .UFDT slots before load- 
ing a program, and programs themselves may alter .UFDT. 


■DAT/. UFDT Number 
+N 

+ 2 
+ 1 

-15 


.DAT Contents 
nondisk handler 

disk handler 
disk pack handler 

none assigned 


.UFDT Contents 

UlCg 

uic 2 

UIC 1 


Comment 


This UIC is ir- 
relevant 

I/O to this slot 
will go to files 
in UIC 1 

I/O to this slot 
will go to files 
in UIC 2 

This UIC is ir- 
relevant 


The operator has logged in under UIC^. He has assigned some nondisk 
handler to .DAT+N, the DECdisk to . DAT+2 , and the Disk Pack unit 0 to 
.DAT+1, and NON (no handler) to .DAT -15. In addition, he has changed 
the .UFDT assignment for .UFDT+1 to UIC 2 » I/O to .DAT+N will not 
reference the UIC, since UIC's are relevant only to disk I/O. I/O to 
.DAT+2 will reference UIC.^ while I/O to .DAT+1 will reference UIC 2 . 
The UIC for .DAT -15 is irrelevant, since no handler is assigned. 


Figure 4-4 

Relationship Between the .DAT and the .UFDT 
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4.7.3 File Protection 

DOS offers a simple form of file protection. Each User File Directory 
has a protection code and each file has a protection code. The protec- 
tion codes only protect a programmer's files from other users - not 
from himself. If a User File Directory is protected, then the protec- 
tion codes for each file are in effect. If the user File Directory 
has been specified as unprotected, then no protection is provided for 
any file in the directory. There are three three possible protection states 
for files in a protected User File Directory. 

File Protection Codes : 

1 = Unprotected, with the exception that the file may 

not be deleted and the number of blocks may not 
change, if the directory is protected. 

2 = Write protected, if directory protected. 

3 = Read/Write protected, if directory protected. 

User File Directories may have one of two protection states: 

File Directory Protection Codes : 

0 = Unprotected 

1 = Protected 

The default protection code for User File Directories is always 1, 
protected. The default protection code for files is established at 
system generation time. 

4.7.4 Organization of Specific Files on Disk 

The disk handlers write out files sequentially, just as the DECtape 
handlers do. On the close of an output file, the disk handlers also 
fill out a Retrieval Information Block (RIB) . The RIB performs the 
same functions as the file bitmap on DECtape, and associates the 
logical sequence of blocks in the file with the physical locations of 
the blocks on the disk. The disk handlers use the RIB to implement 
random access and to delete files. 

After a user has created a disk file, he can access records sequen- 
tially as with DECtape files. He can also read and write physical 
blocks of that file by referencing relative block numbers - The user 
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is prohibited, however, from changing the total number of blocks in 
the file. To do this he must copy the contents of the current file 
into a new, larger file. 

4.7.5 The Disk Handlers 

The disk handlers allow as many concurrently open input or output files 
as there are .DAT slots available to the user, and buffers available to 
the disk handler. The disk handlers operate under a dynamic buffer 
allocation scheme. Whenever the Monitor loads a system or user pro- 
gram, it allocates buffer space. This space is called the buffer pool. 
Whenever a program opens a disk file, the handler obtains a buffer 
from the buffer pool. The handlers return the buffer when the pro- 
gram closes the file. 

The buffers in the buffer pool are available to programs, as well as 
to disk handlers. Whenever a program is using a buffer, however, it 
is unavailable to any other program. 
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DOS SYSTEM MACROS 


5 . 1 INTRODUCTION 

This chapter contains detailed reference information concerning XVM/DOS 
System Macros. I/O Macros (those which have a .DAT slot number as one 
argument) are discussed in Chapter 6. 

5.2 MONITOR-PROCESSED COMMANDS 

The MACRO assembler permits the use of higher-level system instruc- 
tions called "System Macros" which, when used as a source statement, 
can cause a specific sequence of Monitor operations to occur at run- 
time . 

5.2.1 Summary of DOS Monitor System Macros 

Table 5-1, Summary of System Macros, summarizes the non-I/O macros 
which the Monitor implements. The following paragraphs describe the 
individual system macros in detail. 


Table 5-1 

Summary of System Macros 


Name 

Description 

.EXIT 

Requests the System Loader to bring in the Non- 
resident Monitor. 

.GET 

Overlays core with the contents of a named file. 

. GTBUF 

Requests a buffer from the buffer pool. 

.GVBUF 

Returns a buffer to the buffer pool. 

. OVRLA 

Requests the System Loader to load the named core- 
image program. 

.PUT 

Creates a file containing the current core image. 

.SYSID 

Aids in system program version identification. 

•TIMER 

Initializes a time interval after which program 
control passes to a user specified subroutine. 
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5.2.2 DOS System Macro Expansions 

The following standards apply to the descriptions of the System and 
I/O Macros presented in this chapter and in Chapter 6: 

A. Format Conventions 

1. Upper case terminology must be used as stated in the FORMAT 
Description. 

2. Lower case terminology indicates user-supplied information, 
as defined by ARGUMENTS. 

3. Names for user-supplied parameters indicate maximum length 
of field by the number of characters in the name. Thus, 
"namptr" may be a maximum of six characters long, and "num" 
may be a maximum of three characters . 

4 . Brackets O indicate optional quantities. 

5. A bracket on its side (i_j) indicates a space. 

6. Quantities listed vertically and enclosed in braces ( ) 

indicate the user must choose one from the group. 

7. The expansions indicate how one might write an expanded 
macro directly to the assembler. The expansions may appear 
different from expansions produced by the assembler. They 
are, however, functionally equivalent. 

B. Sixbit File Representation 

Many of the System and I/O Macros have a "namptr" argument which points 
to a 3-word block of core in the user ' s program containing the Sixbit 
representation of a file name and extension. This is simply an abbre- 
viated form of ASCII in which the rightmost 6 bits of the ASCII code 
are used. This allows 3 characters to be packed in one word of storage. 
Sixbit packing can be accomplished either by the user program or by the 
MACRO Assembler's .SIXBT pseudo-op. (Refer to the MACRO XVM Assembler 
Language Manual. The example following paragraph 6.8.5 demonstrates 
the use of .SIXBT. 

5. 2. 2.1 .PUT - Creates a file which contains the current core image. 

The size of the file is equal to the minimum of the fQ area size and 
the current system memory size. The value is kept in .SCOM, and will 
be stored in the file (as part of .SCOM in the core image) for use by 
GET and .GET. The file's name and extension will be that found in the 
locations pointed to by namptr. See also .GET. 
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FORMAT: 

. PUTu-jf , namptr 
ARGUMENTS : 

f = (function) determines the startup location for a .GET 
with f=4, or a GET Keyboard command to the Nonresident 
Monitor . 

f = 0 Subsequent load will start at the location 
following the EXPANSION. 

f = 1 Subsequent load will start at current CTRL P 
address . 

f = 2 Subsequent load will start at current CTRL T 
address . 

f = 3 Subsequent load will start at current CTRL S 
address . 

namptr = Pointer to the address of a 3 -word, .SIXBT 

representation of the name and extension of 
the file to be created (unused spaces must 
contain nulls) . The 3-word block must be 
entirely within the lower 32K words of XVM 
memory . 

EXPANSION: 

LOC+O CAL+f 
LOC+1 26 
LOC+2 namptr 

5. 2. 2. 2 .GET - Overlays core with the contents of the file whose name 
is indicated by the Macro argument namptr. The file must have been 
created by a .PUT System Macro, or a PUT command to the Nonresident 
Monitor, and it must reside on the device associated with .DAT -14. 
.GET destroys the current contents of .SCOM, including DATE and TIME. 
The .GET command tests the image size of the file as stored in the 
•SCOM in the image. If the image size is larger than either the size 
of the +Q area or the current system memory size, then the following 
question is asked: 

IMAGE TOO LARGE - CONTINUE (Y/N) ? 

If the reply is "N", control is returned to the Nonresident Monitor. 

If the reply is "Y", the minimum of the +Q area size and the current 
system memory size is copied into the fQ area and into memory. If 
the image size is smaller or equal to both the IQ area size and the 
current memory size, the image will be copied into the IQ area and 
into memory. See also the .PUT System Macro, and the PUT and GET 
commands to the Nonresident Monitor. 
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FORMAT : 

. GETi_jf , namptr 

ARGUMENTS: f = (function) - determines startup location after 

overlay. 

f = 0 Start at location after 

expansion of System Macro 
that created the file. If 
file was created via a .PUT 
command to the Nonresident 
Monitor, load core from the 
file, and await a command 
from the console keyboard. 

Refer to 
the XVM/DOS 
System 
Manual for 
more 
informa- 
tion. 

f = 4 Start at the location spec- 
ified by the .PUT System 
Macro. If the file was 
created via a .PUT call to 
the Nonresident Monitor, 
load core, and await com- 
mand from the console key- 
board . 

namptr = Pointer to the first word of a three-word 
. SIXBT representation of the filename and 
extension for the core image to be loaded. 
(Unused spaces must contain nulls.) The 3- 
word block must be entirely within the lower 
32K of XVM memory. 

EXPANSION: 

LOC+0 CAL+f 
LOC+1 25 
LOC+2 namptr 


5. 2. 2. 3 .GTBUF - Requests a buffer from the buffer pool. If a buffer 
is available from the pool, the Monitor will return the address of the 
first word of buffer in the AC. If no buffer is available, the Resident 
Monitor will return 777777 in the AC. On return, execution begins at 
LOC+3 . LOC+2 can be used as desired. This Macro gives user programs as 
well as handlers access to buffers. 


f = 1 Start at CTRL P 
address 

f = 2 Start at CTRL T 
address 

f = 3 Start at CTRL S 
address . 
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FORMAT : 


. GTBUF 


ARGUMENTS : 


none 

EXPANSION: 

LO C+0 CAL+0 

LOC+1 21 
LOC+2 0 


5. 2. 2. 4 .GVBUF - Allows a user to return to the buffer pool a buffer 
obtained via a .GTBUF System Macro. 


FORMAT : 


. GVBUF 


ARGUMENTS : 


None, at assembly time, but AT RUN TIME, the program 
must load LOC+2 with the address of the buffer to be 
freed. If LOC+2 does not contain the address of an 
allocated buffer, the AC will contain 777777 on return. 


EXPANSION: 

LOC+0 CAL+0 
LOC+1 22 

LOC+2 0 (Load with first address of buffer) 

5. 2. 2. 5 . OVRLA - Requests the System Loader to bring into core and 

start the core image system program whose name is pointed to by the 
Macro argument namptr . If there is not enough room in core to load the 
program requested, the Resident Monitor will return control to LOC+3 . 


WARNING 

All I/O should be completed before issuing 
an .OVRLA. 


FORMAT : 


. OVRLAi_jnamptr 
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ARGUMENTS : 


namptr = (name pointer) first address of the two- 
word . SIXBT representation of the name 
and extension of the file containing the 
program to be brought in. The two-word 
block must be within the lower 32K of 
XVM memory. 


EXPANSION: 

LOC+0 CAL+0 
LOC+1 24 
LOC+2 namptr 


5. 2. 2. 6 .EXIT - Requests the System Loader to bring in the Non- 
resident Monitor. Current contents of core are lost. All unclosed 
output files are destroyed, all input files are closed. 

FORMAT : 

.EXIT 

ARGUMENTS : 

none 

EXPANSION: 

LOC+0 CAL+0 
LOC+1 15 


5. 2. 2.7 .TIMER - Allows programs to schedule routines to be called 
after specific time intervals. 


Refer to Chapter 2 of the XVM/DOS System Manual for programming rules 
for these routines. 


FORMAT : 


. TIMERi__innnnnn , addres 


ARGUMENTS: 


nnnnnn = (time interval) number (in decimal radix) of 
clock ticks from "now" after which the sub- 
routine is to be called 

1 R 

0<nnnnnn 2 -1 or 262143 
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addres = address of the routine to be called after the 
specified number of ticks. This address must 
be within the lower 32K of XVM memory. 

EXPANSION: 

LOC+jZS CAL+0 
LOC+1 14 
LOC+2 addres 
LOC+3 -nnnnn 

5. 2. 2. 8 .SYSID - Aids in system program version identification. The 
.SYSID macro performs two functions: 

1. It defines several parameters. These parameters might be used 
for conditional assembly control. The following parameters 
are defined: 

%XVM = 1/indicates XVM hardware 
%VERSN = 1/indicates version 1 (in VIA) 

%RELES = 1/indicates release A (in VIA) 

These parameters are not altered by .SYSID if they are already defined. 
Remember that these parameters cannot be defined by .SYSID until the 
macro has been invoked? and that the parameters will only be defined 
the first time .SYSID is invoked. The definitions of these parameters 
are not included in the assembly listing. 

2. It provides a convenient method for inserting a text string 
into an assembler statement. 

FORMAT: -*| . SYS ID front , back 

EXPANSION: front @ XVM^jVlA @ back 
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PROGRAMMED I/O COMMANDS 


6.1 INTRODUCTION 

This chapter describes the concepts, commands and methods for incor- 
porating input/output commands in MACRO assembly language programs. 
FOCAL and FORTRAN users need not, in general, be concerned with the 
contents of this chapter, since each of these languages has its own 
I/O capability. 

The DOS IOPS is the interface between any program and the external 
world of I/O devices. I/O device handlers are provided for all stan- 
dard devices and are described in Chapter 9. These handlers relieve 
the user of the burden of I/O considerations and unwanted device 
dependence . 

6.2 GENERAL I/O COMMUNICATIONS 

Under DOS, all I/O transfers and subsidiary I/O operations are 
initiated by programmed I/O commands called I/O Macros, as shown 
in Table 6-1. These I/O Macros are macro instructions which have a 
.DAT slot as one argument. As with System Macros, they are permanently 
defined in the MACRO Assembler. 

As can be seen from Table 6-1, there are four I/O Macros within the 
DOS Software System which effect data transfer: .READ, .WRITE, 

. RTRAN and .TRAN. The first three permit operation using the standard 
DOS file structures described in Chapter 4 and provide the most 
device independent approach to I/O programming. The .TRAN Macro 
functions independently of DOS file structures. 
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Table 6-1 

SYNOPSIS OF DOS I/O MACROS 


Macro 

Function 

.CLEAR 1 

Initializes a directory on a directoried mass storage 
device. All data on the device is lost and fresh bit 
maps and directories are written. 

.CLOSE 1 

Terminates use of a file. In the case of output files on 
the disk, fills out the Retrieval Information Block (RIB) 
for later .RTRAN commands. 

.DLETE 1 

Deletes a file from a directory on a mass storage device. 

.ENTER 

Primes a directoried mass storage device to accept an out- 
put file. 

. FSTAT 

Checks the directory on a mass storage device for the 
existence of a named file. 

. INIT 1 

Initializes the device and device handler. 

. MTAPE 

Provides special commands for industry compatible magnetic 
tape. 

.RAND 

Opens a disk file for random processing via .RTRAN macros. 

.READ 

Transfers a logical record, or the requested number of words, 
whichever is smaller, from the device to the user's I/O 
buffer. 

.RENAM 1 

Renames a file in a directory of a mass storage device. 

. RTRAN 

Allows input and output to access any block in a pre- 
existent file on the disk (any word if RF) . 

.SEEK 

Checks for a named file in a directory on a mass storage de- 
vice. If the file is present, prepares it as an input file. 

.TRAN 

Gives independence from DOS file structure by allowing in- 
put and output access to Magtape, or to any block on disk or 
DECtape located by its physical block number. A file can be 
opened for sequential or random access and still be .TRANed 
via the same .DAT slot without destroying the file structure. 

.USER 

Allows programs to change the .UFDT. 

.WAIT 

Waits for I/O already started to complete, then continues. 

. WAITR 

If I/O is complete execution continues. If I/O is 

not complete control is transferred to the specified address. 

.WRITE 

Transfers data from user's I/O buffer to the device. 

1 At completion of these operations , the buffer is given back to the 
buffer pool, if disk or DECtape "A" version I/O handler is used. 
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6*2.1 .READ/ .WRITE/ .RTRAN Operations 

•READ and .WRITE Macros permit the user to sequentially input and out- 
put records of a file consisting of ASCII lines or binary data to any 
device in the standard set of XVM I/O devices. The .RTRAN Macro 
provides the user with random access to physical blocks when using 
the disk devices. Initially, files are created sequentially (.WRITE) 
and can subsequently be accessed both sequentially (.READ) and 
randomly (.RTRAN) . Data which is to be read and written by these com- 
mands must reside entirely within the lower 32K of XVM memory. 

6.2.2 .TRAN Operations 

The last data transfer macro (.TRAN) functions only on mass storage de- 
vices. It provides I/O transfer capability at the device level with- 
out regard for established file structures. This type of transfer 
provides for user-designed file structuring. The .TRAN function per- 
mits data transfers directly to and from all XVM memories including 
memory above the first 32K. 

Much of the remainder of this chapter is devoted to I/O programming 
within the DOS file structures and, specifically, to the methods 
and considerations involving the creation of sequential files. Little 
can be said here about the utilization of the .TRAN and .RTRAN Macros 
since the system places the burden of data structuring, interpretation, 
checking and packing on the programmer. 

6.3 SEQUENTIAL FILE PROCESSING 

I/O operations under DOS consist of the transfer of ASCII or binary 
logical records between buffer areas in the system or user program 
and I/O devices represented by the device handlers in IOPS . (A logical 
record is defined as the amount of ASCII or binary data which is trans- 
ferred to or from a program as the result of the execution of a single 
.WRITE or .READ I/O Macro.) The size of each logical record depends 
upon the structure of the data (Data Mode) and the device or set of 
devices addressed. The format and data structure of each logical 
record output in IOPS and Image Data Modes is described below. For 
Dump Mode, however, no particular requirements are placed on the user 
by the system. Dump mode is provided to permit user-created data 
structures within the DOS file structure. 
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6.3.1 Logical Record Format, IOPS and Image Modes 

Each, logical record to be output in IOPS and Image Modes must be 
formatted as shown in Figure 6-1. The record, consisting of 2n 
18-bit words contains a two word header (called header word pair) 
followed by 2n-2 words of ASCII or binary data. 


Word 0 

1st word of header 

l header word 

Word 1 

2nd word of header 

J pair 

Word 2 




2n-2 words of data 

\ ASCII 

• 


[ or 

Word 2n 


J Binary 


Data 


Figure 6-1 IOPS and Image Mode Logical 
Records Format 


The header word pair is a communications link between the user's pro- 
gram and the I/O device handlers in IOPS. It is divided into various 
fields which contain information about the data which resides in the 
record. The information in some fields is supplied by the program to 
assist the device handlers in writing records and subsequently retriev- 
ing them. Other fields contain information which is provided by the 
device handlers for use by the user or system program when verifying 
records during input. Refer to paragraph 6.4.3 for an explanation of 
Dump Mode record format. 

6. 3. 1.1 Header Word Pair Format - Figure 6-2 shows the format of the 
header word pair. Of particular significance is the Word Pair Count; 
it specifies the number of word pairs of data in each logical record. 

In addition, for all Data Modes except Dump Mode, it is the prime 
logical record terminating condition when using mass storage devices. 
This term should not be confused with the Word Count, which is an 
argument used in I/O Macros. The Word Count gives the actual size of 
the I/O buffer which contains the logical records prior to output and 
after input operations (see 6.7). 
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6. 3. 1.2 Using the Header Word Pair Before Output - The program must 
calculate and then set the appropriate word pair count in bits 1-8 of 
header word zero, unless they have already been set by a device handler 
on input (i.e., an input device handler set up the header word pair 
for each record read) . This count overrides the word count passed to 
IOPS by the .WRITE system Macro. The I/O mode field, bits 14-17, is 
set by the device handler from the I/O mode argument specified in the 
.WRITE Macro. The checksum word need not concern the user since check- 
sums are computed by IOPS (when using IOPS Data Modes) . 


HEADER 
WORD 0 

1 = IGNORE 
CHECKSUM ON 
BINARY INPUT 


8 9-* ►ll 12 13 14 



COUNT 

1 1 1 1 1 1 1 

1 1 

V 

1 

I/O 

1 

► 1 f 

MODE 

1 1 


l— , 




WORD PAIR COUNT, INCLUDING 

UNUSED 





HEADER WORD PAIR 


VALIDITY BITS: 

00-DATA CORRECT 10 = CHECKSUM ERROR 
01=PARITY ERROR 1 1 = BUFFER OVERFLOW 


I/O MODE : 

0000- IOPS BINARY 
0001 = IMAGE BINARY 
0010=I0PS ASCII 
00 1 1 3 I MAGE ALPHANUMERIC 


0100 =UNUSED 
0101 =E0F (LOGICAL) 
0110 =E0M (PHYSICAL) 
0H1 = TAPE LABEL 


HEADER 
WORD 1 


1 1 

— J 1 1 1 1 1 1 1 1 1 1 1 1 

*-1 7 

| | 





CHECKSUM : 

TWO'S COMPLEMENT OF HEADER WORD 0 PLUS DATA 
WORDS ( 0 = CHECKSUM NOT COMPUTED) 



15-0646 


Figure 6-2 

Format of Header Word Pair 


6. 3. 1.3 Using the Header Word Pair Before Input - The user need not 
be concerned with the header word pair since it will be set up by the 
device handler during input to enable the user to determine the status 
of his record after input has terminated. 
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6. 3. 1.4 Using the Header Word Pair During Input - The Word Count 
(specified in the .READ Macro) is used by the device handler to deter- 
mine the maximum number of locations provided in the user's input buf- 
fer for the data being read. If the Word Count is exceeded before the 
end of the record (as specified by the Word Pair Count) has been reached 
or if a parity or checksum error has occurred, the handler sets the 
validity bits of header word 0 as required to indicate the error. 

6. 3. 1.5 Using the Header Word Pair After Input - Header word 0 of each 
logical record input should be examined by the user program to determine 
whether errors have occurred. Specifically, the validity and I/O Mode 
bits should be tested. If both checksum and parity errors are detected 
by a handler, priority is given to a parity error and the checksum 
error will not be indicated. IOPS ignores checksum errors on binary 
input if bit 0 of word 0 is set to 1. When examining the I/O Mode Bits 
(bits 14-17) the occurrence of a buffer overflow condition means that 
the user program's I/O buffer, as specified by the Word Count in the 
.READ Macro, is not large enough to contain the record just read. 

The portion of the record which caused the overflow is lost. In addi- 
tion, IOPS uses the I/O Mode Bits to indicate that either the physical 
end-of-medium (EOM) or the logical end-of-file (EOF) has been reached; 
otherwise, these bits specify the Data Mode of the Record. 

6 . 4 DATA MODES 

The device handlers within IOPS allow data transfers via .READ and 
.WRITE Macros in one of the five Data Modes listed below: 

IOPS Binary (Mode 0 ) 

IOPS ASCII (Mode 2) 

Image Binary (Mode 1) 

Image Alphanumeric (Mode 3) 

Dump (Mode 4) 

Data Modes permit the user to select the data structuring features of 

the system which are important to his application. The device independ- 
ent features of the system can be enhanced through the use of the IOPS 
Modes, which are standardly used by all DOS System programs (e.g., 
both FORTRAN and MACRO accept source programs in the form of IOPS 
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ASCII files and produce object code as IOPS Binary files) . Conversely, 
if specific device dependent features are desired. Image Mode can be 
used primarily with non-mass storage devices, and Dump Mode can be 
used primarily with mass storage devices. 

6.4.1 IOPS Modes 

The IOPS Data Modes, both ASCII and Binary are the standard data struc- 
tures of the DOS Software System. Using these modes, all ASCII and 
Binary data input is verified and converted into standard records re- 
gardless of its original form on the input device. Before output, 
programs must format data into standard IOPS records. On output, IOPS 
calculates checksums and either reconverts the data to the form re- 
quired by the output device or, in the case of mass storage devices, 
stores the data in the standard record format. 

6. 4.1.1 IOPS ASCII - IOPS ASCII is used by DOS System 
Software as the standard ASCII Data Mode. It accommodates the entire 
7-bit ASCII (1968) 128 character set as shown in Appendix A. All 
alphanumeric data, whatever it.s original form on input (i.e., 8-bit 
ASCII, Hollerith, etc.) or final form on output, is converted 
internally by the non-mass storage device handlers and stored in 
core and on mass storage devices as "5/7 ASCII". This term refers 

to the internal packing and storage scheme used for IOPS ASCII 
in which five 7-bit ASCII characters are packed into two contigu- 
ous 18-bit words. Figure 6-3 shows this relationship. ASCII packed 


WORD 0 


u o ^ 


1ST CHARACTER 

2ND CHARACTER 

3RD CHARACTER 

1-4 




17 


____ 

— UNUSED 

WORD 1 

3RD CHARACTER 
5-7 

4TH CHARACTER 

5TH CHARACTER 

— 


15-0647 


Figure 6-3 5/7 ASCII Packing Scheme 
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in this form can be stored "as is" on any mass storage device. I/O 
requests involving 5/7 ASCII should be made using an even word count 
argument to accommodate the paired data. ASCII data is ordinarily in- 
put or output character-by-character via non-mass storage devices such 
as teleprinter, line printer, paper tape reader and punch. It can 
also be stored on mass storage devices in 5/7 form (see Figures 6-4 
and 6-5) . On paper tape an IOPS ASCII character is defined as a 7-bit 
character with even parity in the eighth (high order) bit, in keeping 
with USASCII standards. Further, IOPS performs a parity check on 
input, prior to the 5/7 packing and on output IOPS generates the cor- 
rect parity. 

Non-parity IOPS ASCII occurs in data originating at a Model 33, 35, 
or 37 Teleprinter, without the parity option. This data always appears 
with the eighth (high order) bit set to 1. Apart from parity checking, 
the IOPS routines handle IOPS ASCII and non-parity IOPS ASCII data identi- 
cally . 



Figure 6-4 IOPS ASCII on Paper Tape 


— WORD PAIR COUNT 
8 14 17 


CHECKSUM 


J 


•HEADER WORD PAIR 
ABC J 

'IN 5/7 ASCII 


Figure 6-5 IOPS ASCII in I/O Buffers 
and on Mass Storage Devices 
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Each logical record is an alphanumeric line followed by a Carriage 
Return (CR) of ALT MODE. CR (or ALT MODE) is a required line terminator 
in IOPS ASCII mode to non-mass storage. Unused character positions in 
the IOPS Word Pair after the CR or ALT MODE are ignored. Control char- 
acter scanning is performed by some device handlers for editing or con- 
trol purposes (refer to Chapter 9) . 

On input, each IOPS ASCII .READ results in a 5/7 packed ASCII line being 
placed in the program's I/O buffer. If this line is to be interpreted, 
it must be unpacked by the program. Conversely, on output each .WRITE 
assumes that the data in the user's I/O buffer is a 5/7 packed ASCII 
line. Thus, it is up to the program performing IOPS ASCII data trans- 
fers to unpack each input line and pack each output line. Appendix B 
contains assembly listings of generalized packing and unpacking routines 
which can be incorporated into user programs as required. 

6. 4. 1.2 IOPS Binary _ IOPS Binary data is blocked in an even number 
of words, with each block preceded by a two-word header (see Figure 
6-6) . On paper tape (see Figure 6-7) , IOPS uses six bits per frame, 
with the eighth channel always set to 1, and the seventh channel con- 
taining the parity bit (odd parity) for channels 1 through 6 and 
channel 8. The parity feature supplements the checksumming as a 
data validity provision in paper tape IOPS binary. 


WORO PAIR COUNT 
(INCLUDING HEADER WORD PAIR) 



HEADER 
WORD PAIR 



I l PAIRS OF 18-BIT 
[ f BINARY WORDS 



15 - 065 ! 


Figure 6-6 IOPS Binary in I/O Buffers and on Mass Storage Devices 
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Figure 6-7 IOPS Binary Data on Paper Tape 


6.4.2 Image Modes 

Image Mode data, both. Image Alphanumeric and Image Binary/ is read/ 
written and stored (on mass storage devices) in the form established by 
the source or terminal device. These modes permit the user to take 
advantage of the data structuring features peculiar to non-mass storage 
devices. These modes are strictly device dependent and no checking, 
packing or interpretation of data is performed. For example, when deal- 
ing with Alphanumeric data the teleprinter editing features RUBOUT and 
CTRL U, described in 9.3.1 are ignored, as well as the IOPS ASCII line 
terminators Carriage RETURN and ALT MODE. With the line printer, how- 
ever, Carriage RETURN and ALT MODE are accepted as legal line termina- 
tors . 

Image Alphanumeric Mode results in the transfer of all eight bits of 
an ASCII character to or from an I/O buffer (see Figures 6-8 and 6-9) . 
Image Binary data is unchecksummed binary and appears on paper tape, in 
I/O buffers and on mass storage devices as shown in Figures 6-10 and 
6 - 11 . 



Figure 6-8 Image Alphanumeric Data in I/O Buffers 

and on Mass Storage Devices 
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Figure 6-9 Image Alphanumeric Data 
on Paper Tape 



Figure 6-10 Image Binary in I/O Buffers 
and on Mass Storage Devices 


TAPE CHANNEL 


8 7 6 5 4 3 2 1 

FEED 


DIRECTION 
OF TAPE 
MOVEMENT 



Figure 6-11 Image Binary on Paper Tape 
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6.4.3 Dump Mode 

Dump Mode permits complete freedom in data structuring in the context 
of a file structured environment 1 . Data input or output in Dump Mode 
is not interpreted, checked or packed and record length is not limited 
by the software. Dump Mode is used to output from, or load directly 
into, any core memory area. All data transferred are treated strictly 
as 18-bit binary words (i.e., core images). No Header Word Pair is 
used. Each .READ or .WRITE statement in Dump Mode requires arguments 
which merely define the core starting address of the area input or 
output and the number of words (Word Count) to be transferred. Dump 
Mode is normally used with mass-storage devices although paper tape 
I/O is possible. With paper tape, data is interpreted on output or 
input as three six-bit frames per 18-bit word (see Figure 6-11) . On 
input from paper tape, the 7 channel is ignored and the 8 channel must 
be punched in each data frame. This requirement is automatically met 
by the paper tape punch handler when output is in dump mode. 

6.4.4 Logical Record Terminators 

IOPS detects the end of each logical record transferred using a pre- 
defined group of terminators or terminating conditions. These logical 
record terminators vary with the Data Mode in effect, the particular 
device or set of devices involved, and the transfer direction (input 
or output) . Table 6-2 summarizes the terminating conditions for logi- 
cal records during input and output for each IOPS Data Mode. Detailed 
information on terminating conditions for each I/O device handler 
is provided in Appendix C. 


l The .TRAN System Macro (paragraph 6.7.13) permits user specified 
file structuring as well as data structuring. A Dump Mode transfer 
can be thought of as effectively a file structured .TRAN. 
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Table 6-2 


Logical Record Terminators 


Data Mode 

Input 

Output 

IOPS ASCII 

Carriage RETURN or ALT MODE 

Word Pair Count 1 

EOM 

Word Count 2 
EOF 1 

Carriage RETURN 

ALT MODE 

Word Pair Count 3 

IOPS Binary 

Word Pair Count 
EOM 

Word Count 2 
EOF 1 

Word Pair Count 

Image Alpha- 
numeric and 
Image Binary 

Word Pair County- 
Word Count 
EOM 
EOF 1 

Word Pair Count 

Dump 

Word Count 

EOM 

EOF 1 

Word Count 

1 Mass storage only. 

2 If word count is exceeded before a terminator is encountered, IOPS 
sets bits 12 and 13 of Header Word 0 to 3 (Buffer Overflow). 

3 If the Word Pair Count is 1 or less, the line is ignored; if greater 
than 1, ignore the count and accept Carriage RETURN or ALT MODE (non- 
file oriented devices only) . Bulk storage devices require a word 
Pair Count greater than 0 and less than 200g; otherwise an IOPS 23 
error will occur. 
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6.5 I/O BUFFERS 
6.5.1 Space Allocation 

Each system or user program which is to perform I/O operations must 
allocate an I/O Buffer for each I/O device and Unit (i.e., a .DAT 
slot) that is to be used simultaneously. This can be accomplished 
by, but is not limited to, one of the methods described below. 

Static buffer allocation can be accomplished through the use of the 
MACRO Assembler 1 s. BLOCK pseudo-op as described in the MACRO Assembler 
Language Manual . A tag must be used to permit referencing of the 
buffer in each I/O Macro. For example: 


.DEC 

INBUF .BLOCK 52 

OTBUF .BLOCK 254 
.OCT 


/CREATES 52(10) WORD BUFFER 
/CALLED INBUF 

/CREATES 254(10) WORD BUFFER 
/CALLED OTBUF 


Dynamic buffer allocation can be performed through the use of the 
Monitor Macros .GTBUF and . GVBUF described in Chapter 5. Alternatively, 
the user can create a buffer at execution time from free core by simple 
calculation, using the information contained in the System Communica- 
tion Registers, .SCOM+2 and .SCOM+3 (absolute locations 102 and 103 
octal) . These registers contain the lowest and highest addresses of 
the registers in unused core, below the system bootstrap respectively. 

6.5.2 Size Considerations 

When choosing a maximum I/O buffer size to specify in the Word Count 
arguments for .READ and .WRITE I/O Macros, both the set of possible 
devices and the Data Mode must be considered. The buffer must reside 
entirely within the lower 32K of XVM memory. As a general rule, when 
using IOPS and Image Modes, the maximum logical record size can never 
exceed the maximum buffer sizes specified in Table 6-3. These are 
based on physical device limitations. In Dump Mode, however, there 
are no restrictions on buffer size provided the buffer resides en- 
tirely within the lower 32K of XVM memory; a logical record can occupy 
any number of physical blocks on a mass storage device. Programs 
which are to communicate with a number of devices using IOPS or Image 
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Table 6-3 

Maximum I/O Buffer Sizes for IOPS and Image Mode Transfers 


Device 

Max. Buffer Size 3 

Data Modes 

Comments 

Disk Cartridge 
(RK) 

254 

( 3 7 6 8 ) 

All 

IOPS and Image Modes 
permit more than one 

DECdisk (DK) 

254 

(376 8 ) 

(376 8 ) 

All 

logical record (de- 

Disk Pack (DP) 

254 

All 

pending on its size) 
per physical block. 

DECtape (DT) 

255 

< 377 g) 

< 37 V 

All 

Dump Mode records can 

Magtape (MT) 

255 

All 

span an unlimited num- 
ber of blocks. 

Teleprinter (TT) 

34 

00 

CM 

IOPS ASCII 

Allows for 80 5/7 
packed characters . 

Plotter (XY) 

34 

NJ 

OD 

IOPS ASCII 


XY11/XY311 


IOPS Binary 



74 


Image Alpha- 

(Allows for 72 char- 




numeric 

acters ) 

Paper Tape 
Reader (PR) 

52 

00 

All 


Paper Tape 
Punch (PP) 

52 

CO 

VJ< 

All 


Line Printer 
LP-15/LP-11 

36 

00 

IOPS ASCII 

Allows for 80 5/7 

(80 column) 

84 


Image Alpha- 

packed characters 
Allows for 80 




numeric 

characters 

Line Printer 
LP-15/LP-11/ 

56 

00 

O 

r- 

IOPS ASCII 

Allows for 132 5/7 

LS-11/LV11 




packed characters. 

(132 column) 

136 


Image Alpha- 

Allows for 132 




numeric 

characters 

Card Reader (CD) 
CR03B/CR15/CR11 

36 

(44g) 

IOPS ASCII 

Allows for 80 5/7 
packed characters plus 
a handler supplied 
Carriage RETURN. 

VP15A Storage 
Tube Display 

32 

CO 

o 

IOPS ASCII 

Allows for 75 5/7 
characters (only 72 
can be displayed) 


74 


Image Alpha- 

Allows for 72 

L 


L 

numeric 

— L 

characters 


1 


The Octal representation of buffer 
after issuing a .INIT, indicating 
for IOPS Modes. Other sizes shown 
specified. 


sizes is shown for values returned 
the maximum size which can be used 
can be used with Image Modes as 


6-15 




Programmed I/O Commands 


Modes must limit the output buffer size to that of the device with 
the smallest buffer. Conversely, in setting-up input buffers, the 
size must be at least as large as that for the device with the larg- 
est buffer size. 

For example; consider the I/O buffer requirements for a program which 
must be capable of transferring IOPS ASCII lines to either a tele- 
printer or the DECdisk. The maximum I/O buffer size for the teleprinter 
is 34 1q locations and for the DECdisk is 254 1Q locations. Therefore, 
the user should choose the smaller size since his program must deal 
with both. More importantly, if the ASCII records stored on the DEC- 
disk were greater than 34 locations in length, the user could not trans- 
fer them back to the teleprinter without truncation or reformatting. 

6.6 SPECIFYING I/O DEVICES 

As mentioned in preceding chapters, the Monitor maintains a Device 
Assignment Table (.DAT), which has "slot" numbers that correspond 
directly to logical device numbers. Each .DAT slot contains a pointer 
to a device handler and a unit number when applicable (for Disk Pack, 
DECtape or Magnetic Tape units) . All I/O communication in the DOS 
Monitor environment is accomplished by the logical/physical device 
associations provided by the Device Assignment Table. 

When writing a MACRO program which uses I/O Macros, it is necessary 
to incorporate the MACRO Assembler's . IODEV pseudo-op somewhere in 
the program to specify to CHAIN or the Linking Loader which logical 
device numbers (.DAT slots) are to be used. The .IODEV pseudo-op 
causes the Assembler to generate a code in the object program which 
instructs CHAIN or the Linking Loader to load the device handlers 
associated with the specified .DAT slots. 

For example: .IODEV 3,5,6 causes the device handlers assigned to 

.DAT slots 3, 5, and 6 to be loaded with the program containing the 
pseudo-op . 

6.7 I/O MACRO DESCRIPTIONS 

The paragraphs which follow describe the function of the I/O Macros, 
the information to be provided by the user (arguments) , and the 
assembly language expansion of each^ . Either the I/O Macros of their 

"''Paragraph 5.2.2 describes conventions and symbology used in present- 
ing the I/O Macros. 
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assembly language expansions can be incorporated directly in MACRO 
programs. Typical I/O command sequences are discussed in paragraph 
6.8.4. Except for the .TRAN function, all I/O buffers, file name 
blocks, and addresses must be entirely within the lower 32K of XVM 
Memory. In general, the system does not check to see that these re- 
strictions have been faithfully applied. 

6.7.1 . CLEAR 

Initializes all bit maps and directories on the device. Eliminates 
all references to files in the directory of the device associated 
with the named .DAT slot. In order to avoid clearing a directory 
when its files are still in use, the directory is checked for open 
files. If there are no open files, the directory is cleared; other- 
wise, an IOPS 10 error message (file still active) results. .CLEAR 
to a system device may only be used under the MIC, because it will 
destory the system. 


FORMAT : 


ARGUMENTS : 


EXPANSION: 


. CLEAR ds 

ds = .DAT slot (octal radix) 

(all values below are octal) 

LOC+fS CAL [-]ds&777 
LOC+1 5 


6.7.2 .CLOSE 


When directed to a .DAT slot used for input : Clears all flags related 

to that .DAT slot. This deactivates the .DAT slot, and another . INIT 
will be necessary to use the .DAT slot in the future. Any allocated 
buffer is returned. 


When directed to a .DAT slot used for output : Allows all associated 

output to finish, and then writes an end-of-file (EOF) 1,2 software 
indicator in the last header word pair. If the .DAT slot is assoc- 
iated with a directoried device, any earlier file of the same name 
and extension is deleted from the directory. Operation then continues 
as for input files (above) . 


1 001005 

776773 

2 2005 

775773 


all except non-directoried 
non-directoried magtape. 


magtape . 
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FORMAT : 
ARGUMENTS : 

EXPANSION: 


.CLOSE^C-Jds 

ds = .DAT slot (octal radix) 

(all values below are octal) 

LOC+0 CAL,__,[-]ds&777 
LOC+1 6 


6.7.3 . DLETE 

Deletes a file from the directory of the device associated with the 
named .DAT slot. 

If the specified file cannot be found, the contents of the AC will 
be 0 on return. 


FORMAT : 

. DLETE ^ [-] ds , namptr 

ARGUMENTS : 

ds = .DAT slot number (in octal radix) 

namptr = Pointer to the address of the first of 3 

words containing the .SIXBT representation 
of the name and extension of the file to be 
deleted (unused spaces must contain nulls) . 
The 3-word block must reside entirely with- 
in the first 32K of XVM memory. 

EXPANSION: (all values below are octal) 

LOC+0 CAL+1000 l __,[-]ds&777 

LOC+1 2 

LOC+2 namptr 


6.7.4 . ENTER 


Initializes a directory for a new output file. The file will be placed 
on the device associated with the .DAT slot named as one of the para- 
meters to the macro. Transfers control to the Monitor error handler 
to print the appropriate error message if there is no available space, 
in the file directory. ENTER is ignored by non-directored output 
devices . 

FORMAT : 

. ENTER [-] d s , namptr , p 
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ARGUMENT : 

ds = .DAT slot (octal radix) 

namptr = Pointer to the address of the first of three 
words containing the .SIXBT representation of 
the name and extension of the file to be crea- 
ted. (Unused spaces must contain nulls) . The 
3-word block must reside entirely within the 
first 32K of XVM memory. 

p = Disk file protection code to be assigned. 
Possible values for p: 

1 - file is unprotected 

2 - file is WRITE protected 

3 - file is READ/WRITE protected 

Is p is omitted, the default protection code 
established at system generation time is used. 

EXPANSION: (all values below are octal) 

LOC+,0 CAL+1000*Pi_j [-]ds&777 

LOC+1 4 
LOC+2 namptr 


6.7.5 . FSTAT 


Checks the status of a file in a directory. Ignored by non-directoried 
devices. The namptr parameter points to the name and extension of the 
file whose status is desired. On return, the AC will contain the first 
block number of the file, if the directory lists a file with the in- 
dicated name. The contents of the AC will be zero on return if the 
specified file is not on the device. It is recommended that program- 
mers use .FSTAT prior to executing .SEEK if they wish to retain pro- 
gram control when a file is not in the directory. 


Bits 0 through 2 of LOC+2 must be set to zero prior to the execution 
of the CAL. On return, these bits of LOC+2 will contain a code in- 
dicating the type of device associated with .DAT slot ds. 


0 = non-directoried device 

1 = DECtape file structure 

2 = RF DECdisk file structure 

3 = RP Disk Pack file structure 

4 = MAGtape 

5 = RK Disk Cartridge file structure 
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FORMAT : 

. FSTAT [-]ds , namptr 

ARGUMENTS : 

ds = .DAT slot (octal radix) 

namptr = Pointer to the address of the first of three 
words containing the .SIXBT representation of 
name and extension of the file (unused spaces 
must contain nulls) . The 3-word block must 
reside entirely within the first 32K of XVM 
memory. 

EXPANSION: (all values below are octal) 

LO C+0 CAL+3jZfj00 t . J [-]ds&777 

LOC+1 2 

LOC+2 namptr 


6.7.6 . INIT 


Initializes a device and device handler. Programmers must give a 
.INIT prior to giving any I/O commands referencing the named .DAT 
slot. Any .DAT slot initialized via a .INIT must eventually be closed 
via a .CLOSE. 


The handler that services any .INIT will return (in LOC+3 of the ex- 
pansion) the maximum size of the line buffer allowed for that hand- 
ler. For example, DTA will return 377 (255 1Q ) in LOC+3, and DKA will 
return 376 (254^) in LOC+3 of the expansion. 

FORMAT: . INIT ^ [-]ds , dd, restrt 

ARGUMENTS : 

ds = .DAT slot (octal radix) 
dd = Direction of data flow 

0 - file will be an input file 

1 - file will be an output file 


restrt = Restart address. Although restrt must be in- 
included to avoid assembly time errors, it 
has meaning only for .INIT commands referen- 
cing. .DAT slots assigned to the teleprinter. 
The restart address must reside within the 
lower 32K of XVM memory. 

EXPANSION: (all values below are octal) 

LOC+0 CAL+dd*l)W l _ J [-]ds&777 
LOC+1 1 
LOC+2 restrt 

LOC+3 0 (Handler will return maximum buffer size 
in LOC+3.) 
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NOTE 


Bits 5, 6 and 8 of LOC+0 provide added infor- 
mation for the VT15 XVM software, the line 
printer handler and the disk handlers. See 
the individual handler descriptions for more 
information. Bit 7 of LOC+0 should always 
be 0 . 

6.7.7 . MTAPE 


Performs functions unique to industry-standard magnetic tape, i.e., 
functions for non-directoried magnetic tape. Limited functions are 
also provided on DECtape and disk (see Chapter 9) . See descriptions 
of appropriate handlers for more information. 


FORMAT : 


. MTAPE [-] ds , nn 


ARGUMENTS : 


ds = .DAT slot number (in octal radix) 

nn = code number of magnetic tape function or 
configuration: 


00 

- 

rewind to 

load point 


02 

- 

backspace 

record 


03 

- 

backspace 

file 


04 

- 

write end- 

■of-file 


05 

- 

skip record 


06 

- 

skip file 



07 

- 

skip to logical end of tape 


10 

- 

7-channel, 

even parity, 200 

bpi 

11 

- 

7-channel , 

even parity, 556 

bpi 

12 

- 

7-channel, 

even parity, 800 

bpi 

13 

- 

9-channel , 

even parity, 800 

bpi 

14 

- 

7-channel, 

odd parity, 200 

bpi 

15 

- 

7-channel , 

odd parity, 556 

bpi 

16 

- 

7-channel, 

odd parity, 800 

bpi 

17 

- 

9-channel , 

odd parity, 800 

bpi 


EXPANSION: (all values below are octal) 

LOC+0 CAL+nn*1000 l _ J [-]ds&777 
LOC+1 7 


6.7.8 .RAND 


Opens a disk file for random access via . RTRAN macros. Returns the 
number of blocks in the file in LOC+3 of the expansion. 
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FORMAT : 

.RAND,_j £-]ds , namptr 

ARGUMENTS : 

ds = .DAT slot (octal radix) 

namptr = Pointer to the first word of a 3-word .SIXBT 
representation of the filename and extension 
of the file to be opened (unused spaces must 
contain nulls) . The 3-word block must reside 
entirely within the lower 32K of XVM memory. 

EXPANSION: (all values below are octal) 

LOC+jZf CAL+50,00 1 __ 1 [-] ds&777 
LOC+1 2 
LOC+2 namptr 
LOC+3 0 

6.7.9 . READ 

Returns the next logical record to the user's I/O buffer. If the 
record is longer than the user's I/O buffer, the handler will fill the 
buffer and the rest of the record will be lost. If the record is 
shorter than the user's I/O buffer, the handler will use only the part 
of the buffer it needs. The handlers use several indicators to deter- 
mine the length of record. Appendix C, Input/ Output Data Mode Ter- 
minators, shows which handlers use what indicators for each data mode. 

Since I/O operations and internal data transfers may proceed asynchron- 
ously with computation, a .WAIT command must be used after a .READ 
command before the user attempts to access the data in his I/O buffer, 
or to read another line into it. 

The user should always check bits 14 through 17 of the first word of 
the I/O buffer for end-of-medium and end-of-file conditions. In non- 
Dump modes, the user should also interrogate bits 12 and 13 of the 
first word of the I/O buffer to ensure that the record was read without 
error . 


FORMAT : 


ARGUMENTS : 


• READ|_| [-]ds, m, bufadd, wdc 

ds = .DAT slot (octal radix) 
m = Data Mode, as follows: 
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0 

1 

2 

3 

4 


Data Mode 
Data Mode 
Data Mode 
Data Mode 
Data Mode 


is IOPS Binary 
is Image Binary 
is IOPS ASCII 
is Image Alphanumeric 
is Dump Mode 


bufadd = address of user 1 s I/O buffer 

wdc = word count (decimal radix) , including the 

two-word header. wdc should equal the length 
of the buffer at bufadd. 


EXPANSION: (all values below are octal) 

LOC+0 CAL+m*1000,_ l [-]ds&777 
LOC+1 10 
LOC+2 bufadd 
LOC+3 -wdc 


NOTE 

The user must assume that the I/O buffer 
lies entirely within the lower 32K of 
XVM memory. 


6.7.10 . RENAM 

Renames a file (useful only with directoried devices) . The old name 
and extension are pointed to by namptr; the new name must be located 
at namptr+3 . The AC will be zero on return if the file specified at 
namptr cannot be found. 

FORMAT : 

.RENAM. . [~]ds . namptr 

ARGUMENTS : 

ds = .DAT slot (octal radix) 

namptr = pointer to the old name and extension (new 
name is at namptr+3. (Unused spaces must 
contain nulls.) The 6-word block must reside 
entirely within the lower 32K of XVM memory. 

EXPANSION: (all values below are octal) 

LOC+Z CAL+2Z0Z l __ 1 [-]ds&777 
LOC+1 2 
LOC+2 namptr 

6.7.11 .RTRAN 

Allows random access to blocks in a file opened via a .RAND I/O macro. 
Programmers may read or write into any block of a file, but may not 
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change the length of the file. 

FORMAT : 

. RTRAN. . [-]ds , d, relblk, bufadd, beg, wdc 

ARGUMENTS: 

ds = .DAT slot (octal radix) 
d = direction: 

0 - direction is input 

1 - direction is output 

relblk = block number (octal radix) relative to be- 
ginning of the file . . . first block is 
block 1, etc. 

bufadd = address of I/O buffer in user's core space. 

beg = first physical word of physical block to be 
read or written. .. ignored for output to disk 
pack and disk cartridge? must be octal radix, 
0<beg<_375 . 

wdc = number of words, starting with beg, to be 

read or written. .. ignored for output to disk 
pack and disk cartridge; must be DECIMAL 
radix, 0_<_wdc£(253-beg) . 

EXPANSION: (all values below are octal) 

LOC+0 CAL+4jW t _,[-]ds&777 
LOC+1 2 

LOC+2 d*400000+relblk 
LOC+3 bufadd 
LOC+4 beg 
.DEC 

LOC+5 -wdc 

NOTE 

The user must assume that the I/O buf- 
fer lies entirely within the loader 32K 
of XVM memory. 


6.7.12 . SEEK 

Opens a file for input on a director ied device. .SEEK is ignored 
by non-directoried input devices. 

If the file is listed in the device's directory, the handler reads 
the first block of the file into a buffer (A subsequent .READ will 
obtain the first logical record in the user's I/O buffer.) 


If the file is not listed in the device's directory, the handler will 
pass control to the error handling routine in the Monitor. If the 


6-24 



Programmed I/O Commands 


user wishes to retain control in the case that the desired file is not 
in the directory, he should first issue an . FSTAT command. 


FORMAT : 


. SEEK , . d s , namptr 

ARGUMENTS: 

ds = .DAT slot (octal radix) 

namptr = pointer to the three-word .SIXBT representation 
of the name and extension of the file to be 
opened for input. (Unused spaces must be null- 
filled.) The 3-word block must reside entirely 
within the lower 32K of XVM memory. 

EXPANSION: (all values below are octal) 

LOC+0 CAL,^ [-]ds&777 
LOC+1 3 
LOC+2 namptr 


6.7.13 . TRAN 


Allows device-dependent, non-directoried input and output to any mass 
storage device. Users address such blocks by their physical locations. 
•TRAN should be followed by a .WAIT macro, to ensure that the transfer 
has been completed. 

FORMAT : 

• TRANuf-Jds, d, blknum, bufadd, wdc 

ARGUMENTS : 

ds = .DAT slot (octal radix) 
d = direction of transfer: 

input, forward--. 7 \ \ 
output, forward^ 
input, backward (DECtape only) 
output, backward (DECtape only) 

Input, true 9-track (Magtape only) 
output, true 9-track (Magtape only) 

NOTE 

DECtape blocks must be read in the direction 
they were written in, in order to obtain mean- 
ingful results. 

blknum = block number (octal radix) of block at which 
to start input or output; I/O with word count 
larger than one block will continue with the 
next contiguous block; end of tape or disk 
will cause IOPS error. 
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bufadd = address of I/O buffer; I/O buffer must be at 
least as long as wdc. The buffer may reside 
anywhere in XVM memory, including core above 
the first 32K. 

wdc = number of words to be transferred (decimal 

radix) . The maximum word count permitted is 
131,072. 

EXPANSION: (all values below are octal) : 

LOG+0 CAL+d*1000| , [-J ds&777 

LOC+1 13 
LOC+2 blknum 
LOC+3 bufadd 
LOC+4 -wdc 


6.7.14 .USER 


Allows users to dynamically assign UIC 1 s to desired UFDT slots, thus 
permitting access to UFD 1 s other than the UFD specified at LOGIN time 
(refer to paragraph 8.4) . Protection for the specified UFD and its 
files remains in effect. .USER must be issued before the . INIT of the 
I/O sequence for which UFD change is desired (see example below) . 

.USER will also take effect if the proceeding I/O call to the same 
.DAT slot, as that given in the .USER, is .CLOSE, .RENAM, .MTAPE (re- 
wind) , or . DLETE . 

FORMAT : 

. USER ds , uic 

ARGUMENTS: 

ds = .UFDT/. DAT slot number (octal radix) 

uic = (UIC) the . SIXBT representation of the three- 
character User Identification Code. 

EXPANSION: (all values below are octal) 

LOC+0 CALu £-] ds&777 
LOC+1 23 
LOC+2 uic 

For example: 

.USER 1 , ABC 
.INIT 1,00 
.USER 1 , CDE 

.SEEK 1 , FILE 


.CLOSE 1 


This .SEEK searches for FILE under the 
UFD called ABC. 
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. INIT 1 , 0,0 

.SEEK 1 , FILE This .SEEK searches for FILE under the 
. UFD called CDE . 


6.7.15 .WAIT 


Obtains and holds control until the user's I/O buffer is available 
after an I/O operation. Should be used before accessing an I/O buf- 
fer after .READ, .WRITE, .TRAN, and .RTRAN commands. 


FORMAT : 
ARGUMENT : 
EXPANSION: 


.WAIT^ [-] ds 

ds = .DAT slot (octal radix) 

(all values below are octal) 

LOC+Z CALuj [-]ds&777 
LOC+1 12 


6.7.16 . WAITR 


Returns control to the address specified as an argument to the CAL, 
if I/O is not complete. If I/O is complete, returns control to the 
next location after the macro expansion. It is the user's respon- 
sibility to return to the .WAITR command, or do another one. 


FORMAT : 


. WAITR u[-]ds, waitad 


ARGUMENTS : 


ds = .DAT slot (octal radix) 

waitad = address to which control will be returned, 
if I/O is incomplete. The address must 
reside within the lower 32K of XVM memory. 

EXPANSION: (all values below are octal) 

LOC+Z CAL+lZZZi__i[-]ds&777 
LOC+1 12 
LOC+2 waitad 


6.7.17 .WRITE 


.WRITE transfers a logical record from the user's I/O buffer to the 
handler's buffer. 
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The .WRITE command establishes the mode in which data is transferred. 
The Header Word Pair Count determines the maximum amount of data to 
be transferred in all modes except Dump, which references the "wdc" 
argument . 

The only limits on data transferred in Dump Mode are the amount of 
data buffer space available and the capacity of the device accepting 
the data. On physically blocked devices, such as DECtape and disk, 
the handler will start from its current position in a block and fill 
successive blocks until the transfer is complete. If a Dump Mode 
transfer does not completely fill the last block used, a subsequent 
Dump Mode transfer will fill that block, before using any other. 

•WAIT or . WAITR must be used after a .WRITE command, before the user's 
I/O buffer is used again, to ensure that the transfer to the device 
has been completed. 

FORMAT : 

.WRITE. .£-]ds.m, bufadd, wdc 

ARGUMENTS : 

ds = .DAT slot (octal radix) 
m = data mode for transfer 

0 - IOPS Binary 

1 - Image Binary 

2 - IOPS ASCII 

3 - Image Alphanumeric 

4 - Dump 

bufadd = address of user's I/O buffer containing data 
to be transferred. 

wdc = word count, number of words to be transferred 
(decimal) , (relevant for Dump Mode transfers 
only) . 

EXPANSION: (all values below are octal) 

LOC+0 CAL+m*1000 | _ 1 [-]ds&777 
LOC+1 11 
LOC+2 bufadd 
LOC+3 -wdc 


NOTE 

The user must assure that the I/O buffer lies 
entirely within the lower 32K of XVM memory. 
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6.8 USING I/O MACROS 

The programmer must observe certain conventions when incorporating I/O 
Macros into a program. In general, consideration must be given to: 

• The physical device and its capabilities 

• I/O device handler characteristics 

• The I/O Macro Syntax 

• The I/O Macro Sequence for the desired file access/ 
structure (see Chapter 4) 

6.8.1 Physical Device Capabilities 

The considerations involved here are obvious and need little comment. 
Simply stated, the user must understand the gross differences between 
various devices. For example, a. READ cannot be issued to a line 
printer. Similarly, binary data cannot be output to a teleprinter. 

6.8.2 Device Handler Characteristics 


Many of the standard XVM I/O devices available to DOS users are 
provided with several handler versions. These versions vary from one 
to another as to the I/O Macros and Data Modes which are acceptable to 
them. Some versions permit the full set of I/O Macros and Data Modes 
to be used, while others incorporate a subset of these features. These 
limited capability handlers are provided primarily for use where core 
allocation is a problem, since they are smaller than those with 
greater capability. The user must be aware of these handler differ- 
ences, particularly if he wishes to utilize device dependent charac- 
teristics. Detailed descriptions of the DOS device handlers are 
provided in Chapter 9. 

6.8.3 I/O Macro Syntax 

The order in which I/O Macros are used is important to the success of 
an I/O transfer. There are basic rules of syntax which must be ad- 
hered to in order to avoid run time I/O (IOPS) errors. These rules 
apply to any I/O sequence directed to the same .DAT Slot. 


1. . INIT must always be issued before any other I/O 

Macro. It initializes the handler associated 
with the referenced .DAT slot for either input or 
output. Subsequent . INITs can be used to uncon- 
ditionally terminate an unwanted I/O operation. 
Exception: A .INIT will not terminate I/O to 

the teletype. See the description of the Tele- 
type handler in Chapter 9 for a method to stop 
I/O in progress. 
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Table 6-4 


Legal I/O Macro Combinations 


Commands 
which, ma 
follow: 


. IN IT 
. FSTA.T 
. RENAM 
. DLETE 


.CLEAR 
. SEEK 
.ENTER 
.RAND 


. MTAPE 
.READ 
.WRITE 
. RTRAN 


.TRAN 
.WAIT 
. WAITR 
.CLOSE 


.USER 


Commands which may precede 

Misc.l Directory Mai ntenan ce iFile Structur e I nitia lize Data Transfer Mi sc. 

FSTAT LRENAM I. DLETE I. CLEAR TTSEEK I. ENTER 7. RAND I. MTAPE .READ I. WRITE I. RTRAN I . TRAN .WAIT T WAITR I. CLOSE 



X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 


X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

•p 

■? 


Notes: ? = Illogical Combination 

X = Legal combination 
Blank = Illegal Combination 
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2. .CLOSE (or .MTAPE Rewind, for Magtape) must always 

be the last Macro issued in the sequence. It termin- 
ates the current I/O operation and use of the asso- 
ciated .DAT slot. Another . IN IT must be issued if 
subsequent transfers are to be made via this .DAT slot. 

3. I/O transfers to directoried devices (Disk, DECtape or 
Magtape) require the use of .SEEK before .READ, .ENTER 
before .WRITE and .RAND before .RTRAN. 


4. Intermixing of .SEEK, .ENTER, .MTAPE, and .RAND 
Macros in the same I/O sequence (i.e., occurring 
between an . INIT and a .CLOSE referencing the same 
.DAT slot) is illegal. 

The acceptability of specific combinations of I/O Macros is shown in 
Table 6-4. 


6.8.4 Selecting an I/O Macro Sequence 


The user has the capability of selecting command sequences which empha- 
size either device independence or device dependence, as his needs 
dictate. Much of the device independence of the DOS system is ob- 
tained by using I/O Macro sequences which are general enough to be 
acceptable to a wide range of device handlers. These sequences are 
based on sequential file access via the .READ and .WRITE I/O Macros, 
which are recognized by all DOS Device Handlers. Simply by using 
.INIT - .READ (or .WRITE) - .CLOSE sequences along with the applicable 
IOPS Data Modes, a user's program has the capability of communicating 
with all non— mass storage devices (including teleprinter, paper tape 
reader and punch, line printer, card reader and VPl 5 A CRT) . By 
adding the .FSTAT, .SEEK, and .ENTER Macros, the same program can, 
in addition, utilize the system's mass storage devices (including 
Disk, DECtape and Magtape) . The examples below further illustrate 
these sequences. 

Example 1 - Typical Output Sequence 

. IODEV 2 /Use .DAT slot 2 

.INIT 2,1,RSTRT /Initialize .DAT slot 2 for output (1) 


Optional check for existing file and 
device type, e.g. , .FSTAT, .RENAM, 
•DLETE, etc. 
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Example (cont'd) 


Process data for output 


.ENTER 2, NAME 



NAME . SIXBT "FIL@@@SRC" 

BUFF .BLOCK 42 


/Output a record to .DAT slot 2 
/from BUFF in IOPS ASCII Mode. 

/Wait till buffer is free 


/File name in .SIXBT 

/Spaces are null filled (i.e., @=null) 
/I/O buffer 


Example 2 - Input Sequence 
. IODEV 1 

!lNIT 1 , 0 , RSTRT 


/Use .DAT slot 1 

/Initialize .DAT slot 1 for input (0) 


Optional check for exist- 
ing file and device type 
(e.g., . FSTAT, . RENAM , 
and .DLETE Macros) . 


.SEEK 1 ,NAME 



NAME .SIXBT "FIL@@@SRC" /File name in .SIXBT. Spaces are 
BUFF .BLOCK 42 /null filled (i.e., §=null) 

/I/O buffer 
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Device dependent I/O programming is based in large part on the use of 
device-specific I/O Macro sequences and to a lesser degree on the struc- 
ture (Data Mode) of the data. For example: .RTRAN can only be 

used with disk handlers; non-mass storage devices do not need .SEEK 
or .ENTER for operation (they ignore them). Furthermore , the inter- 
pretation of data using the Image and Dump Data Modes becomes the 
user's responsibility, rather than the handler's. The user who does 
not need device independence can eliminate unnecessary instructions 
in his program and obtain additional free core for other purposes. 

For instance, assume that in the previous examples a directoried device 
was never to be used. The programmer could then economize by eliminat- 
ing all I/O Macros associated with I/O on directoried devices such as 
.SEEK, .ENTER, .CLEAR, . DLETE , . FSTAT. 


Figure 6-12 shows the relationship between standard I/O Macro sequences 
and the various I/O devices and file s tructure/access features of the 
DOS-15 system. Except for . INIT and .CLOSE, there is no implied order 
to the macros in any particular I/O sequence shown (the reader should 
refer to paragraphs 6.7 and 6. 8. 3.1 for this information). 

6.8.5 Programming Example 

The following example illustrates the use of I/O Macros in a MACRO 
Assembly Language program. The program accepts an ASCII line from the 
teleprinter keyboard, creates a file on the disk (or if the .DAT slot 
is properly assigned, on any other directoried device) , reads the file 
back from the disk, and prints it on the teleprinter. Before subse- 
quent keyboard inputs, the program prints the following message on 
the teleprinter: 


FILE ALREADY PRESENT! ! 

DO YOU WISH TO KEEP IT ? (Y OR N AND CR) > 

By typing a Y on the keyboard, the file previously created is saved 
and a new file is created for the next line input from the keyboard. 
By typing an N rather than a Y, the next line input from the keyboard 
is written on the disk using the filename associated with the line 
previously typed (that line will be deleted) . 

The name of the file is initially ECHO 001. a new file name is 
created each time a Y is typed in response to the above message by 
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Figure 6-12 

-/O Macros Applicable to Specific Devices and Data Access Techniques 
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incrementing the location in the program called NAME+2 which initially 
contains the "001" extension of the file name in Sixbit trimmed ASCII 
( . SIXBT pseudo-op). This produces a series of uniquely named files 
(one each time a Y is typed) as follows: ECHO 001, ECHO 002, ECHO 003, 

ECHO 004, etc. 


The arguments used by the I/O Macros in this program are given symbolic 
names by means of MACRO direct assignment statements at the beginning 
of the program. These names permit the programmer to change the real 
values of these arguments readily and also facilitate recall. The 
listing shown below is the source listing and is followed by an assem- 
bly listing which shows how Macros are expanded at assembly time. The 
reader may wish to compare these expansions with the Macro descriptions 
in the beginning of this chapter. 


Programming Example - Source Listing 



.TITLE 

DKECHO 

OISK-7 



TT I *6 



TTQ = 5 



IN = 0 



DUTsl 



I QPS=2 




, I0DEV 

5,6,7 

BEGIN 

, I N I T 

DISK,0UT.RESTRT 


. INIT 

TT 1 i IN, RESTRT 


. init 

ttq, out, RESTRT 

START 

.fstat 

DISK, name 


SHA 



JMP 

UPDATE 

readkb 

.WRITE 

TTO, IQPS,MSG3*34 


.read 

TTI , IOPS, BUFFER, 34 


.wait 

TT I 


.eject 



lac 

UQSW 


S2a 



JMP 

NEWFIL 

WRITE 

.ENTER 

DISK, NAME 


.write 

DISK, IOPS, BUFFER, 34 


.wait 

DISK 


.CLOSE 

DISK 

REAQ0T 

.INIT 

DISK, IN, RESTRT 


.SEEK 

DISK, NAM£ 


.READ 

DISK. IOPS, BUFFER, 34 


.wait 

DISK 


.EJECT 



.write 

TTQ, IOPS, BUFFER, 34 


.wait 

TTO 

RESTRT 

.CLOSE 

TTO 


.CLOSE 

TTI 


.CLOSE 

DISK 


JMP 

BEGIN 


/initialize: disk output, 
/teletype - INPUT, 

/AND TELETYPE: output 
/IS FILE present? 

/N0> INPUT KEYBOARD 
/YES, OUTPUT MSGl AND MSg 2 
/TYPF A GO AHEAD SYMBOL, {>> 
/INPUT IoPS ASCII FROM KEYBOARD 
/WAIT UNTIL INPUT COMPLETE 

/test update switch 

/0 REPLACE INPUT FILE 

/^1=SAVE INPUT; CREATE NE w OUTPT 

/CREATE NEW DISK FILE 

/OUTPUT DATA ON DISK 

/WAIT UNTIL OUTPUT COMPLETED 

/close file 

/INITIALIZE DISK INPUT 
/LOCATE file ’’NAME” 

/read INTO BUFFER 
/WAIT UNTIL read COMPLETE 

/OUTPUT TO TELETYPE 
/WAIT UNTIL OUTPUT COMPLETE 
/TERMINATE TELETYPE OUTPUT, 
/TELETYPF INPUT, 

/AND DISK INPUT/QUTPUT 
/LOOP FOR UPDATE OPTION 


6-35 



Programmed I/O Commands 


Programming Example - Source Listing (Cont.) 


UPDATE 

.WRITE 

TTO, I0PS,MSGi#34 


.WAIT 

TTO 


.eject 



.write 

TTO, I0PS,MSG2i34 


.WAIT 

TTO 


.read 

TT1 , I OPS , COM , 8 


.WAIT 

TTI 


lac 

COM + 2 


and 

( 774O00 


sad 

(544000 


JMP 

YES 


DHh 

UDSW 


JMP 

REAQKB 

YES 

CLC 



DAC 

UDSW 


JMP 

READK8 

NEWFIL 

LAC 

N A M E ♦ 2 


LRS 

3 


rtr 



rar 



lrs 

3 


rtr 



RAR 



LLS 

6 


AND 

(777 


TAD 

a 


lrs 

6 


rtl 



RAL 



LLS 

3 


rtl 



ral 



LLS 

3 


AND 

( 070707 


XOR 

( 6 06060 


DAC 

NAME + 2 


JMP 

WRITE 

NSG1 

mSG2-MSG1/2*1000 


{? 


/OUTPUT mSGI 
/AMU MSG? 

/ON 

/TELETYPE: 

/READ response 

/WAIT UNTIL READ COMPLETE 

/GET FIRST WORD 

/SAVE F I pST seven bits 

/IS CHAR A Y? 

/NO i SET TO REPLACE INPUT FILE 
/LOOP TO READ KEYBOARD 
/SET UPDATE SW, TO SAVE 
/INPUT, CREATE NEW OUTPUT 
/LOOP TO READ KEYBOARD 
/change EXT 

/ueast significant digit of 
/sixbt value of last char in ext 
/strip off high pa«t of code 

/least significant digit of 
/sixbt value of middle char in ext 
/STRIP off high part OF SlXBT CODE 

/put back in ac 

/STRIP OF HIGH ORDER PART OF REMA I N I N( 
/SJXBT CODE FOR LAST EXT CHAR 
/increment TO MAKE NEW EXT 
/REVERSE PROCESS TO FIX ijP EXT IN 
/PROPER SIXBT 


/TO CREATE NEW OUTPUT 

/wpc for header word 0 


.ASCII "FILE ALREADY » 

.ASCII "PRESENT !I "<15> 

.eject 

MSG2 MSG3-MSG2/2*1000 /WPC FOR HEADER WORD 0 

0 

.ASCII "DO YOU WISH TO KEEP IT ?" 

.ASCII "(Y OR N aNl) CR) > " < 1 7 5 > 


M$G3 

COM-*SG3/2«1300 

r% 


.ASCII 

" > " < 1 7 5 > 

COM 

.block 

10 

buffer 

.block 

42 

NAME 

.SIXBT 

"ECHOP®001 

UDSW 

.END 

BEGIN 
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page: 


OKECHC 001 DKECHO 


o\ 

l 

CO 

<1 


1 







.TITLE OkECWO 


2 



000007 

A 


D ! SK=7 



3 



000006 

A 


TT ! =6 



4 



000005 

A 


T T 0 = 5 



5 



000000 

A 


I M = 0 



6 



000001 

A 


OUTsl 



7 



000002 

A 


10PS«2 



8 







.I0UEV 5*6,7 


9 

00000 

R 




begin 

, I N I T DISK, OUT, RESTRT 

/INITIALIZE DISK OUTPUT, 


0 00 00 

R 

001007 

A 

* G 


CAL + OUT«1000 DISK«777 



00001 

R 

000001 

A 

*G 


1 



00002 

R 

000074 

R 

*G 


RESTrT+0 



00003 

R 

000000 

A 

*G 


0 


10 

00004 

R 

000006 

A 

*G 


. I N X T TT I » I N » REST RT 

CAL + I N*1000 T T I 5 7 7 7 

/teletype input, 


00005 

R 

000001 

A 

*G 


1 



00006 

R 

000074 

R 

«G 


restrt+0 



00007 

R 

000000 

A 

*G 


0 


11 

0 001 0 

R 

001005 

A 

*G 


. I N I T TTOiOUT.REStRT 

CAL + CUT*1000 TTQ&777 

/and teletype output 


00011 

R 

000031 

A 

#G 


1 



00012 

R 

000074 

R 

*G 


RESTrT+0 



00013 

R 

000000 

A 

*G 


0 


12 

00014 

R 




start 

.fstat DISK, NAME 

/IS FILE present? 


00014 

R 

003007 

A 

•G 


CAL + 3000 D I SKA777 



00015 

R 

000002 

A 

*G 


2 



00016 

R 

000301 

R 

*G 


NAME 


13 

00017 

R 

740200 

A 



SZA 

/NO, INPUT KEYBOARD 

14 

00020 

R 

600133 

R 



JMP UPDATE 

/YES, OUTPUT MSGl AND MSG2 

15 

30021 

R 




READK9 

.WRITE TTO, I0PS«MSG3,34 

/type a go ahead symbol (>) 


00021 

R 

002005 

A 

#G 


CAL + IOPS»1000 TTOS 777 



00022 

R 

000011 

A 

*G 


11 



30023 

R 

000223 

R 

*G 


MSG3 







»G 


, DEC 



00024 

R 

777736 

A 

*G 
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Programming Example - Assembly Listing CCont. ) 


PAGE 

2 

DKECHO 

001 

DKECHO 



16 








.READ tT1.10PSiBUFFER.34 

/INPUT IOPS ASCII FROM KEYBOARD 



00025 

R 

002006 

A 

*G 


CALMOPS#1000 TTU777 




00026 

R 

000010 

A 

*G 


10 




0 30 27 

R 

000237 

R 

*G 


8 UFPER 








*G 


.DEC 




000 30 

R 

777736 

A 

*G 


-34 


17 








.WAIT T T I 

/WAIT UNTIL INPUT COMPLETE 



0 0 0 31 

R 

000006 

A 

*G 


CAL T T I 5 7 7 7 




0 00 32 

R 

000012 

A 

*G 


12 


18 










19 


00033 

R 

200304 

R 



LAC t.iOSW 

/TEST UPDATE SWITCH 

28 


0 0 0 34 

3 

740200 

A 



32 A 

/0 REPLACE INPUT FILE 

21 


00035 

P 

600136 

R 



JMP mEWFIL 

/-IsSAVE INPUT! CREATE NEW QUTPT 

22 


000 36 

P 




WRITE 

.ENTER DISK, NAME 

/CREATE NEW DISK FILE 



00036 

R 

000007 

A 

*G 


+ C A L *1000 0 I SKS777 




00037 

R 

000004 

A 

*G 


4 




P 00 40 

R 

000301 

R 

*G 


NAME 


23 








.WRITE disk, IQPS,BUFFER,34 

/OUTPUT DATA ON DISK 



00041 

R 

002007 

A 

tt G 


CAL* I OPS*1000 D1SK&777 




000 4 2 

R 

000011 

A 

*G 


11 




0 0 0 4 3 

R 

000237 

R 

*G 


BUFFER 








*G 


.DEC 




0 00 4 4 

R 

777736 

A 

«G 


-34 


24 








.WAIT nISK 

/WAIT UNTIL OUTPUT COMPLETED 



00045 

R 

000007 

A 

*G 


CAL DISKK777 




00046 

R 

000012 

A 

#G 


12 


25 








.CLCSF DISK 

/CLOSE FILE 



00047 

R 

000007 

A 

tt G 


CAL D I S K & 7 7 7 




00050 

R 

000006 

A 

tt G 


6 


26 


0 0 O 5 1 

R 




readdt 

. I N 1 T DISK, JN.RESTRT 

/initialize disk input 



0 0051 

R 

000007 

A 

*G 


CAL*IN»1000 0 I S K & 7 7 7 




00052 

R 

000001 

A 

*G 


1 




00053 

R 

000074 

R 

*G 


RESTRT *0 




0005 4 

R 

000000 

A 

*G 


0 










.EJECT 
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(T> 


PAGE 

3 dkecmo 001 


OKECHO 


27 

0(2055 

R 

000007 

A 

«G 

, SEtK DISK, NAME 

CAL OISK«777 


000 56 

R 

330003 

A 

#G 

3 


03057 

R 

000301 

R 

*G 

name 

28 

0 00 6 0 

R 

002007 

A 

*G 

.read nISK, lOPS,yuFFE 

CAL + IOPS«1000 DISK«777 


30061 

R 

300010 

A 

«G 

10 


00062 

R 

000237 

R 

*G 

BUFFER 






*G 

,0EC 


30063 

R 

777736 

A 

*G 

-34 

29 

30364 

R 

000007 

A 

*G 

.WAIT DISK 

CAL D1SK«777 


30065 

R 

000012 

A 

*G 

12 

31 






.WRITE TTO, TOPS# BUFFER 

30066 

ft 

032005 

A 

#G 

CAL + I OPS#1003 TT0S?77 


00067 

R 

000011 

A 

#G 

11 


"1007 P 

R 

000237 

R 

*G 

buffer 






*G 

.DEC 


00071 

R 

777736 

A 

»G 

•*34 

32 

30072 

ft 

000005 

A 

*G 

.WAIT TTO 

CAL TTC5777 


30073 

R 

000012 

A 

*G 

12 

33 

00074 

R 



RESTRT 

.CLOSE TTO 


00074 

R 

000005 

A 

•G 

CAL TT0S777 


00075 

R 

000006 

A 

*G 

6 

34 

30076 

« 

000006 

A 

*G 

.close tti 

CAL T T I 67 7 7 


00077 

R 

000006 

A 

*G 

6 

35 

00100 

R 

000007 

A 

*G 

.CLOSE DISK 
CAL DISK&777 


00101 

R 

000006 

A 

*G 

6 

36 

00102 

R 

600000 

R 


JMP BEGIN 


.EJECT 


/LOCATE FILE "NAME” 

/READ INTO BUFFER 

/WAIT until reao COMPLETE 
/OUTPUT TO TELETYPE 

/WAIT UNTIL OUTPUT COMPLETE 
/TERMINATE TELETYPE OUTPUTi 

/teletype input, 

/and disk input/output 
/LOOP FOR UPDATE OPTION 
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PAGE A 

OKECMO 

0 01 

OKECHO 



37 

00103 

R 




update 

.write tTO, I0PSiMSG1,34 

/OUTPUT MSGl 


00103 

R 

002305 

A 

*G 


CAL* I OPS*1003 T T 0 4 7 7 7 



00104 

R 

030011 

A 

*G 


11 



00105 

R 

030163 

R 

*G 


MSGl 







• G 


,D£C 



00106 

R 

777736 

A 

•G 


-34 


36 






.wait tto 

/AND MSG2 


0010 7 

R 

000005 

A 

*G 


CAL T TOS 7 7 7 



00110 

R 

000012 

A 

«G 


12 


40 

00111 

R 

002335 

A 

*G 


.WRITE TTO, I0PS» MSG2,34 
CAL* I QPS*1003 TTQ&777 

/ON 


00112 

R 

000311 

A 

#G 


11 



0 0113 

R 

0001/7 

R 

*G 


MSG2 







*G 


.DEC 



a 0114 

R 

777736 

A 

*G 


-34 


41 

00115 

R 

030005 

A 

*G 


.WAIT TTO 

CAL TTQ&777 

/TELETYPE 


00116 

R 

000012 

A 

#G 


12 


42 

00117 

R 

002306 

A 

•G 


,REAQ T T I , I0PS.COM , 8 

CAL+IOPS*1000 T T I 5 7 7 7 

/read response 


00120 

R 

000010 

A 

*G 


10 



00121 

R 

300227 

R 

•G 


COM 







•G 


.DEC 



00122 

R 

777770 

A 

*G 


■» 8 


43 

00123 

R 

000006 

A 

*G 


.WAIT T T 1 

CAL T T I & 7 7 7 

/WAIT UNTIL READ COMPLETE 


00124 

R 

000012 

A 

*G 


12 


44 

00125 

R 

200231 

R 



LAC COM+? 

/get first WORD 

45 

00126 

R 

500305 

R 



AND {774000 

/SAVE FIRST SEVEN BITS 

46 

00127 

R 

540306 

R 



SAD (544000 

/IS CHAR A Y? 

47 

0.0130 

R 

600133 

R 



JMP YES 


48 

00131 

R 

140304 

R 



OZM UDSW 

/NO, SET TO REPLACE INPUT 

49 

00132 

R 

600021 

R 



JMP READKB 

/LOOP TO READ KEYBOARD 

50 

00133 

R 

750001 

A 


yes 

CLC 

/SET UPDATE SW, TO SAVE 


.EJECT 
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PAGE 

5 

D K E r M 0 

001 

DKECWO 




51 


00134 

R 

040334 

R 

0 AC 

uDSw 

/INPUT, CREATE NEW OUTPUT 

52 


00135 

R 

600021 

R 

JMP 

READKB 

/LOOP TO READ KEYBOARD 

53 


0 0 1 3 6 

ft 

200303 

R NEWFIL 

LAC 

NAME *2 

/change ext 

54 


00137 

R 

640503 

A 

l rs 

3 

/least significant digit of 

55 








/sixbt value of last char in ext 

56 


?. 014 0 

R 

742020 

A 

RTR 


/strip oft high part OF CODE 

57 


00141 

R 

740020 

A 

RAR 



58 


0 0 1 4 2 

R 

640503 

A 

lrs 

3 

/least SIGNIFICANT digit df 

59 








/SIXBT value OF MIDDLE CHAR IN EXT 

60 


00143 

R 

742020 

A 

RTR 


/STRIP off high part of sixbt CODE 

61 


00144 

R 

740020 

A 

RAR 



62 


00145 

R 

640636 

A 

LLS 

6 

/PUT BACK IN AC 

63 


00146 

R 

500307 

R 

AND 

<777 

/STRIP of high ORDER PART OF REMAIN 

64 








/SIXBT CODE FOR LAST EXT CHAR 

65 


0 014 7 

R 

340310 

R 

TAD 

<1 

/INCREMENT TO MAKE NEW EXT 

66 


0015 0 

0 

640506 

A 

LRS 

6 

/REVERSE PROCESS TO FIX UP EXT IN 

67 








/PROPER SIXBT 

68 


0 0 1 5 1 

R 

742010 

A 

RTL 



69 


00152 

R 

740010 

A 

RAL 



70 


00153 

R 

640603 

A 

LLS 

3 


71 


0 015 4 

R 

742010 

A 

RTL 



72 


001 55 

ft 

740010 

A 

RAL 



73 


00156 

R 

640603 

A 

LLS 

3 


74 


00157 

R 

530311 

R 

AND 

< 070707 


75 


0 016 O 

R 

240312 

R 

X OR 

< 606060 


76 


00161 

ft 

040333 

R 

DAC 

M A M E> 2 


77 


00162 

R 

600036 

R 

JMP 

WRITE 

/TO CREATE NEW OUTPUT 

78 


00163 

R 

006000 

A MSGl 

MSG2-MSGl/2*1000 

/WPC FOR HEADER WORD 0 

79 


00164 

ft 

000000 

A 

G 



60 


00165 

ft 

432231 

A 

.ASCII 

’’FILE ALREADY " 




O0166 

R 

442500 

A 






00167 

ft 

406312 

A 






00170. 

R 

242632 

A 






00171 

R 

422624 

A 






00172 

ft 

000000 

A 


"PRESENT! I " < 1 5 > 


81 


00173 

ft 

502450 

A 

.ASCII 




00174 

R 

551612 

A 






00175 

R 

472534 

A 






00176 

ft 

120432 

A 
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PAGE 6 DKECHO 001 DKECHO 


cr\ 

i 

to 


83 '40177 R 012000 A MSG2 MSG3-M$G2/2«1000 /WPC FOR HEADER WORD 0 

84 00200 R 000000 A 0 

85 40231 R 422364 A .ASCII "DO YOU w I S w TO KEEP IT ?" 

O0202 R 054636 A 

40203 R 525012 A 

00204 R 744646 A 

40205 R* 441012 A 

00206 R 447500 A 

00207 R 456130 A 

30210 ft 550130 A 

00211 R 446504 A 

00212 ft 037400 A 

86 90213 R 242624 A .ASCII » j Y OR N AND CR ) >"<l75> 

00214 R 047644 A 

90215 R 202344 A 

30216 R 040634 A 

00217 ft 421010 A 

90220 R 351122 A 

90221 R 201037 A 

00222 ft 676400 A 

87 90223 ft 032000 A MSG3 CQM-HSG3/2*1000 

88 90224 R 000000 A 2 

89 90225 R 373720 A .ASCII ">"<175> 

90226 R 000000 A 

90 00227 ft A COM .BLOCK 10 

91 90237 ft A BUFFER , BLOCK 42 

92 90301 ft 350310 A NAME .SjXBT *'ECHO<*<*001" 

00302 R 170030 A 

30303 ft 606361 A 

93 00304 R 300030 A UDSW 0 

94 000000 R ,ENU REGIN 

00305 R 774000 A *L 

30306 ft 544000 A *l 

00307 R 000777 A *L 

0 0310 ft 000001 A *L 

90311 ft 070707 A *L 

00312 ft 606060 A #1 

SIHE*003l3 NO ERROR LINES 
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cr> 


PAGE 7 DKEChO CROSS REFERENCE 


BEGIN 

000011 

9 * 

36 

94 

SUFFER 

00237 

16 

2 3 

28 

com 

00227 

42 

44 

87 

DISK 

000007 

2* 

9 

1 2 



28 

29 

35 

IN 

0 0000 0 

5* 

10 

26 

I0PS 

000002 

7* 

15 

1 6 

MSG1 

00163 

37 

78* 

78 

MSG2 

00177 

4C 

78 

83* 

MSG3 

00223 

1? 

83 

87* 

NAME 

00301 

12 

22 

27 

newfil 

00136 

21 

53* 


OUT 

000001 

6* 

9 

U 

RE ADD! 

O0051 

26* 



READKB 

00021 

1 5* 

49 

52 

RESTRT 

00074 

9 

10 

11 

start 

00014 

12* 



TTI 

000006 

3* 

10 

16 

T TO 

000005 

4 * 

11 

15 



41 



UQSw 

00304 

19 

48 

51 

UPDATE 

00103 

14 

37* 


WRITE 

00036 

22* 

77 


YES 

00133 

47 

50* 



31 

90* 

22 

91* 

23 

24 

25 

26 

27 

23 

28 

31 

37 

40 

42 

83 

87 

53 

7 6 

92* 





26 

33* 





17 

34 

42 

43 


40 

31 

32 

33 

37 

38 


93 * 
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6.8.6 File Integrity Considerations 

In a system such as DOS, which offers a flexible I/O command reper- 
toire, I/O programming requires care. . .otherwise, numerous IOPS errors 
may result. Further, there are I/O sequences which the system allows... 
which, if carelessly used, can result in the destruction of the user's 
files or those of others. The paragraphs below describe some important 
considerations . 

a. Extreme care must be exercised when using the .TRAN macro to 
output to the DECdisk, Disk Cartridge, Disk Pack, DECtape or 
Magtape. The user must know the disk and DECtape file struc- 
tures completely, because .TRAN operates completely outside 
these file structures, and ignores the existence of all direc- 
tories and bit maps. The entire contents of the disk or DEC- 
tape or Magtape, therefore, are vulnerable to the user of 

. TRAN . 

b. Caution should be used when reading a file from the disk se- 
quentially (.READ) from one .DAT slot, while modifying the 
same file via another .DAT slot using random access ( . RTRAN) . 

c. Generally speaking, output files are not recognized by the 
system until they are .CLOSED. Under most circumstances, 
termination of program control and return to the Monitor 
will cause the Monitor to delete any unclosed output files. 
Occasionally, a system crash or other unusual phenomenon 
will cause a disk output file to be truncated. Truncated 
files are the remains of output files that the system did 
not get a chance to delete. Directory listings from PIP 
that contain an asterisk (*) after a file name indicate a 
truncated file. They take up disk space and should be de- 
leted via commands to PIP. 
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CHAPTER 7 

SYSTEM INITIALIZATION 


7 . 1 INTRODUCTION 

This Chapter describes the procedures to be followed when loading, start- 
ing, and tailoring the XVM/DOS Software System. Under normal circum- 
stances, these procedures should rarely need to be used. Occasionally, 
however, a program may enter a runaway condition which could result in 
the inadvertent destruction of a part of the XVM/DOS software residing 
on the system device or in core. In addition, it may be necessary to 
change the XVM/DOS software configuration from time to time to permit 
the use of a new I/O device or system program. These alterations to 
the system may be performed only by those who have access to the sys- 
tem's Monitor Identification Code (MIC). Thus the average user need 
not be concerned with the contents of this chapter (except when loading 
using the XVM/DOS Bootstrap), (Paragraph 7.3.2). 

Chapter 10 contains the operating procedures to be used once the sys- 
tem is loaded and running. 

7.2 HOW THE SYSTEM SOFTWARE IS SUPPLIED 

The XVM/DOS Monitor and System programs are supplied to users on either 
DECtape or Magtape, depending upon the particular hardware configura- 
tion. The bulk of the software system resides on the DECtape or Mag- 
tape medium in a special form which is meaningful only to the DOSSAV 
program, which can transfer the system to the disk. Thus, these tapes 
are often called "disk restore tapes" as they may be used only for this 
purpose. The XVM/DOS software kits and instructions for building the 
initial system are given in the XVM/DOS VIA System Installation Guide . 
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7.3 SYSTEM STARTUP PROCEDURES 


The following paragraphs describe the procedure for loading and start- 
ing the XVM/DOS Software System using the DOSSAV and XVM/DOS Bootstrap 
programs . 

7.3.1 Loading PIREX 

This section applies only to UNICHANNEL Systems. XVM users without the 
UCl 5 hardware option should proceed to Section 7.3.2. UNICHANNEL sys- 
tems must load PIREX before any of the PDP-11 peripherals may be used. 

It is assumed that the system cartridge is running on unit 0. Halt 
the PDP-11 by pressing the ENABLE/HALT console switch down. Stop the 
XVM by pressing the STOP toggle. On both machines, the run light should 
be off. Set the XVM address switches to 17700 (octal). (White line 
shows on bottom of 'on' bit.) Place the ABSLll paper tape in the XVM 
paper tape reader. Press both the STOP and RESET switches simultan- 
eously and then the READIN switch on the XVM console. The paper tape 
should read in, and the XVM should halt (RUN light off) . 

Place 140000 (switches number 14 and 15 are up) in the address switches 
of the PDP-11. (Note that a bit is 'ON' when the corresponding switch 
is up.) Press down the LOAD-ADDRESS switch. Move the ENABLE-HALT 
switch to ENABLE (up) . Press down the START switch. At this point 
the PDP-11 should start (RUN light should come on) . 

Place the PIREX paper tape in the XVM paper tape reader and then press 
the CONTINUE toggle on the XVM. The PIREX tape should read in, and 
the XVM should halt. The PIREX monitor in the PDP-11 should start (RUN 
light on, and bit 0 of the address lights on) . This is the character- 
istic pattern of the PIREX null job. 
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7.3.2 Disk Restoration (DOSSAV) 

The XVM/DOS Software System is transferred from the Disk Restore DEC- 
tapes or Magtapes supplied by Digital Equipment Corporation to the 
appropriate disk device using the DOSSAV utility program. This pro- 
gram provides users with the ability to save and subsequently restore 
all occupied blocks'*" on the disk using either DECtape , Magtape, DEC- 
disk. Disk Cartridge, or Disk Packs as the storage medium. Not only 
is DOSSAV used to install the XVM/DOS System, it can also make addi- 
tional copies of the system currently on the disk, of a newly tailored 
system (i.e., after System Generation), or of the contents of Disk 
Pack or Disk Cartridge unit 1-7 (in the case of multiple Disk Pack, 
Disk Cartridge systems) . 

DOSSAV should be used periodically by the system manager to create a 
"backup" tape of the current system plus user files. These system 
backups should be performed weekly (approximately, depending on system 
activity and the ease of replaceability of user files) and the most 
recent 3 or 4 backup tapes should be saved. If this procedure is 
followed, a minimum of time and effort would be lost in re-building 
the system in the event of serious disk file corruption or accidental 
deletion of files. Note also that DOSSAV may be used to quickly save 
all files of a "data disk", which contains only data files (no system 
files) . 

DOSSAV operations interactively via the console teleprinter and asks 
the user a series of questions to determine which devices and unit 
numbers are to be used and, for Magtape, density and track count in- 
When all necessary information has been obtained, DOSSAV automatically 
begins the specified operation. If a save or restore operation re- 
quires more than one tape, the program stops and outputs a message on 
the teleprinter to that effect. The user can then mount the next tape 
and continue. The program performs error checking to detect both 
hardware and command string errors and output appropriate messages on 
the teleprinter. RUBOUT and CTRL/U are permitted when answering 
questions . 

In addition, the program permits DECdisk users to restore systems 

created in a small DECdisk configuration to an environment with a 

2 

larger DECdisk configuration . The reverse situation, however, is not 

. , 3 

possible. DOSSAV is a stand-alone program supplied in paper tape. 


When a SPOOLER area is present, it is not saved by DOSSAV. 

2 

This type of operation should only be done with master tapes (or 
copies of them) since block 1775- must not be occupied when perform- 
ing a restoration to a system with 5 or more platters. 

3 

For non UC15 systems only. PIREX has to be running for UC15, RK based 
systems; refer to Section 7.3.1. 
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form and is loaded via the high speed paper tape reader using the 
XVM's Hardware Readin Mode (load address 5772/ 1 , restart address 54000 ). 

7. 3. 2.1 Operating Procedures - The following procedures should be 
used when restoring or saving the XVM/DOS System Software (or other 
user-created data on Disk Pack or Disk Cartridge units 1-7) : 

2 

For UC15, RK based systems refer to Section 7.3.1 for the PIREX start 
up procedures. 

a. Place the DOSSAV paper tape in the Paper Tape Reader. 

b. Set the console ADDRESS Switches to 57720 1. 

3 

c. To restore the disk: 

1. Mount the XVM/DOS Disk Restore DECtape or Magtape for the 
appropriate hardware configuration (i.e., DECdisk, Disk 
Pack or Disk Cartridge) on the applicable tape drive. 

2. Set the DECtape drive WRITE ENABLE/LOCK switches to LOCK. 
(Magtape users should remove the Write Enable ring from 
the tape reel . ) 

3. Set the disk READ/WRITE PROTECT switches to ENABLE. 

d. To save the contents of the disk: 

1. Mount a fresh tape on the appropriate tape drive. 

2. Set the DECtape WRITE ENABLE/LOCK switch to ENABLE. 
(Magtape users should install the Write Enable ring on 
the tape reel.) 

e. Set the tape drive unit number switches as desired. 

f. Set all ON LINE/OFF LINE switches of the devices being used 
to ON LINE. 

g. Press the XVM Console Switches STOP and RESET simultaneously, 
then press the READIN switch. (The DOSSAV tape should pass 
through the reader.) 


1 


2 

3 


DOSSAV may be loaded at any of the following octal locations: 17720 
37720, 57720, or 77720. A binary loader precedes DOSSAV on the paper 
tape and this loader moves DOSSAV to bank 2 where DOSSAV actually runs 
the restart address must be 54000g. 

If PIREX is not running. 


LUOOrt V 
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7. 3. 2. 2 Commands - Once the paper tape has been read in, DOSSAV will 
identify itself on the teleprinter and begin to ask the user a series 
of questions about the devices to be used, as shown in Table 7-1. 

Each user response must be terminated by a Carriage RETURN. It should 
also be noted that some of the questions shown are typed out only when 
applicable (i.e., no questions are asked about Disk Pack unit numbers 
or Magtape density, or number of channels if these devices are not to 
be used) . Legal input and output device combinations are shown in 
Table 7-2. 


Table 7-1 
DOSSAV Commands 


Query 

User Responses 

INPUT DEVICE? 

4 

DT = DECtape, MT = Magtape, DK = DECdisk, 
DP = Disk Pack, RK = Disk Cartridge 

UNIT NO? 

Legal unit numbers are 0-7 

SAVE Q AREA 3 (Y OR N) 

Y = SAVE THE CTRL/Q AREA 
N = DO NOT SAVE THE CTRL/Q AREA 

TRACK 5 (7 OR 9)? 

Magtape track or channel number. (If 9 is 
specified, density is assumed to be 800 BPI.) 

DENSITY 1 ' 2 (2,5,8)? 

Magtape recording density: 2=200 Bits Per 
Inch (BPI), 5=556 BPI, 8=800 BPI. 

OUTPUT DEVICE? 

(See INPUT DEVICE above.) 

UNIT NO? 

(See UNIT NO. above.) 

TRACK (7 OR 9)? 

(See TRACK above.) 

DENSITY (2,5,8)? 

(See DENSITY above.) 

DATE CREATED: 

The date that the restore tape was created 
is typed out by DOSSAV. 


All XVM/DOS Magtapes distributed by DEC are 800 BPI, Odd Parity. 

2 

This question is only asked when using 7-track magtape. 

3 

Asked only when saving disks which have a SYSBLK and a +Q Area of 
non-zero length. 

4 

Magtapes with even parity cannot be saved or restored with DOSSAV. 

5 . 

This question is asked only when using magtape. 
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Table 7-2 

Legal DOSSAV I/O Device Combinations 


Input 

Device 

Output 

Device 

DEC- 

disk 

Disk 

Pack 

DEC- 

tape 

Mag- 

tapel 

Disk 

Cartridge 


(DK) 

(DP) 

(DT) 

(MT) 

(RK) 

DECtape (DT) 
Magtape (MT) 
DECdisk (DK) 
Disk Pack (DP) 
Disk Cartridge 

OK 

OK 

Illegal 

OK 

Illegal 

OK 

OK 

OK 

Illegal 2 

OK 

Illegal 2 

Illegal 

OK 

OK 

OK 

Illegal 

Illegal 

OK 

OK 

OK 

OK 

OK 

OK 

Illegal 

Illegal 2 


Once the last question has been answered, DOSSAV proceeds with the 
specified operation. If additional tapes are required to complete 
the restore or save operation, the tape is rewound if the unit number 
is not equal to 0 and the following message is output: 

TAPE DONE. MOUNT ANOTHER 

At this point, the user should either mount a fresh tape, if a save 
operation is being performed, or mount the next tape in the sequence 
established at tape creation, if a restore operation. Then type the 
new unit number on which the tape is mounted followed by a Carriage 
RETURN to proceed with the operation. When the requested operation 
is entirely complete, DOSSAV restarts and identifies itself as before: 

DOSSAV XVM Vnxnnn where: nx is the version and 

INPUT DEVICE? nnn is the edit number 

for this version. 

At this point the current restore or save operation is complete. If 
the XVM/DOS Software was being restored, it is now ready to be started 
as specified in 7.3.3. If other DOSSAV operations are desired, the 
user should proceed again as specified in 7. 3. 2.1. 

7.3. 2.3 Examples of DOSSAV Commands - The following examples illu- 
strate typical DOSSAV commands when restoring and saving the XVM/DOS 
Software System. User responses are underlined. 


^All XVM/DOS Magtapes distributed by DEC are 800 bpi, Odd Parity. 

^Use PIP Utility program with the (H) switch option for this operation. 
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Disk Restoration 


1. Restore DECdisk system from DECtape units 1 and 2: 


DOSSAV XVM Vnxnnn 
INPUT DEVICE? 

UNIT #? 

OUTPUT DEVICE? DK^ 

DATE CREATED : 09-DEC -7 5 

TAPE DONE. MOUNT ANOTHER 

2 ^ 


D OSSA V X V M V n x n n n 
INPUT DEVICE? 


(The user mounted the next tape, 
on unit #2 then typed a 2-^to 
continue . ) 

(Operation complete DOSSAV 
restarts . ) 


2. Restore DECdisk system from Magtape unit 0: 


DOSS A V X V M Vnxnnn 
INPUT DEVICE? MT^ 

UNIT #? JL ^ 

T P A C K (. 7 0 R 9 ? ? 7 
DENS I TV <2, 5, 8)? 

OUTPUT DEVICE? (All XVM/DOS System Disk Restore 

DATE CREATED. 09-DEC-75 Magtapes are 800 BPI, Odd Parity.) 

DOSSAV XVM Vnxnnn (Operation complete) 

INPUT DEVICE? 


3. Restore Disk Pack System from DECtape units 1 and 2: 


I i 0 S S A V X V ii V n xn n n 
INPUT DEVICE? DW* 

UNIT #? 

0 U T P U T D E V 1 C E ? DP 
UNIT #? — 

TAPE DONE* MOUNT ANOTHER 

(The user mounted the next tape 
on unit number 2, then typed a 
2-*^to continue.) 

DOSSAV XVM Vnxnnn (Operation complete) 

I N P i.J T .0 E V I C E ? 


4. Restore Disk Pack system from Magtape unit 1: 


DOSSAV XVM Vnxnnn 
INPUT DEVICE? NT 
UNIT #? 1 
TRACK (7 OR 9)? 

0 U T P U T D E V I C E ? DP -J 
UNIT #? Q_*J 
D A T E C R E A I E D <• 0 9 -■ D h U 


DOSSAV XVM Vnxnnn 
I NF'UT DEV I CE ? 


(Operation complete) 
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5. Restore Disk Cartridge from Magtape unit 0: 


DOSS AM XMM Mnxnnn 
INPUT DEMICE? HT^ 

UNIT #? 

TRACK (7 OR 9 > ? 

OUTPUT DEMICE? RK 
UNIT #? 

D A T E C R E A T E D $ 0 4 D E C 7 5 


D 0 S S A M X M M M n >•( n n n 
INPUT DEMICE? 


(Operation Complete) 


Saving the Contents of the Disk 


The single example below should suffice in illustrating this type of 
operation, since save operations are simply the reverse of restore 
operations . 

Save a Disk pack system on DECtape units 2 and 3: 


DOS SAM XMM Mnxnnn 
INPUT DEMICE? Dfv' 

UNIT # ? Q_-*y 
OUTPUT DEM ICE? IsT^J 
UNIT #? 

TAPE DONE, MOUNT ANOTHER 

3 ^ 


(DOSSAV allows for as many 
DECtapes or Magtapes as are 
necessary to contain the entire 
contents of the specified disk.) 


DOSSAM XMM Mnxnnn (Operation complete) 

INPUT DEMICE? 


7. 3. 2. 4 Error Messages and Meanings - DOSSAV attempts to detect all 
keyboard and run-time errors and to recover if possible. The three 
types of errors which can occur are shown below along with their 
meanings and recovery procedures when applicable. 


a. Command String Errors - These errors occur when a 
question is answered incorrectly. DOSSAV repeats 
the question. 


Message 
ILLEGAL DEVICE 


BAD TRACK 
BAD DENSITY 


Meaning 

Either an illegal device mnemonic (one 
other than DT, MT, DK, RK or DP) or an 
illegal combination of devices (DT for 
input and MT for output) was typed. 

A track number other than 7 or 9 was 
typed . 

A density other than 2(200 BPI) , 5(556 
BPI) or 8(800 BPI) was typed. 
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b. Recoverable Operating Errors - These errors occur when 
one of the I/O devices is not properly set up. When 
the condition has been corrected, operation can be re- 
sumed by typing the unit number of the I/O device that 
has been set up correctly, followed by a carriaqe RETURN 
for the first three messages. For the xx ERROR IGN 
message activate the continue switch on the console 
to continue DOSSAV; otherwise, restart DOSSAV. 


Message 

TAPE NOT READY 


DISK NOT READY 

DISK PACK NOT 
READY 


xx ERROR IGN 


Meaning 

The DECtape or Magtape unit is not switched 
to ON LINE, is not set to WRITE ENABLE, or 
is not set to the unit number specified in 
the UNIT NO? question or two or more tapes 
are on-line and dialed to the same unit number. 

The DECdisk is not set to WRITE ENABLE. 

The Disk Pack unit is not switched to 
ON LINE, is not set to WRITE ENABLE or 
is not set to the unit number specified 
in the UNIT #? question. 

A parity/checksum error exists in the block 
currently being transferred; the block number 
is in the AC, the XVM is faulted. This block 
will be ignored (not saved or restored) and 
the operation continued by pressing the "CONT" 
switch on the XVM console. 

xx = RK/DK/DP 


c. Unrecoverable Errors - Errors associated with these messages 
are primarily hardware errors from which DOSSAV cannot re- 
cover. After the message is typed, DOSSAV restarts itself. 


Message 

DECTAPE ERROR 
MAGTAPE ERROR 
DECDISK ERROR 
DISK PACK ERROR 
DISK ERROR 


Meaning 


Hardware error detected 


ATTEMPT TO RESTORE SYSTEM 
TO WRONG DISK 


BLK 1775 OCCUPIED. NO 
2ND SAT CREATED. 


The user tried to restore 
a DECdisk system using a 
Disk Pack restore tape, 
for example. 

The user did not use a 
master restore tape (i.e., 
block 1775 is occupied) 
when restoring a system 
created for 4 or fewer 
platters to a system hav- 
ing 5 or more platters. 


7. 3. 2. 5 Restart Procedures - The restart procedures below should be 
used to terminate the current operation prematurely or to reinitialize 
DOSSAV if it fails to start up automatically after an error. 
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a. Press the XVM Console Switches STOP and RESET simultaneously. 

b. Set the ADDRESS switches to 54000 . 

c. Press the START Console Switch. 

DOSSAV should then identify itself as when originally loaded, other- 
wise it must be reloaded as described in Paragraph 7.3. 2.1. 

7.3.3 Loading and Starting the Monitor 

The DOS Monitor is loaded into core from either the DECdisk or Disk 

1 

Pack or Disk Cartridge -1- and is automatically started with the XVM/DOS 
Bootstrap Loader program. Once loaded, the bootstrap remains in the 
upper 141g locations of the core bank into which it was loaded, dur- 
ing all normal system operation. The bootstrap not only aids in 
initializing the Monitor, but also acts as an integral part of the 
Monitor as it operates. It is supplied on paper tape in three ver- 
sions. RFBOOT is for use with a DECdisk system, RKBOOT is for use with 
the Disk Cartridge systems and RPBOOT is for use with Disk Pack Sys- 
tems . 

Each time that the XVM/DOS System Software is restored using DOSSAV, 
the bootstrap must be loaded into core. Occasionally, a runaway pro- 
gram or hardware malfunction may cause the destruction of the Monitor 
as it resides in core, and prevent the user from restarting it by 
keyboard command. In this circumstance, it is often possible to re- 
start the bootstrap (unless it, too, has been destroyed) and avoid 
reloading the bootstrap. The paragraphs which follow describe the 
initial loading and restart procedures for the XVM/DOS Bootstrap 
Loader. 

7 . 3 . 3 . 1 Loading the Bootstrap 

a. Select the appropriate version of the bootstrap (either 
DECdisk, Disk Cartridge or Disk Pack) and place it in the 
paper tape reader. 

. b. Set the XVM console ADDRESS switches to one of the two 
addresses shown below in accordance with the maximum 
core size of the system. 


IN. <3 J_ c: J- 


nTDTV <-.-1 , -w 4- ,,vv 

r J.1VJLA O LGL l. 
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Address Maximum Core Size 

57637 24K 

77637 32K or more 

c. Press the console switches STOP and RESET; then press 
READIN. 


Once the bootstrap is loaded, it starts automatically and loads the 
Monitor from the disk 1 . When loading is complete, the Monitor gets 
control and identifies itself on the console teleprinter as follows: 


XVM/DOS Vnxnnn 
ENTER DATE (MM/DD/YY) 


where: nx is the version and 

nnn is the edit number 
for this version. 


The system is now loaded and operable and is ready to accept the key- 
board commands (Chapter 8) in accordance with the operating procedures 
described in Chapter 10. Users with new systems, that is, systems 
which have not previously been tailored, should refer to Paragraph 
7.4. 


7. 3. 3. 2 Bootstrap Restart Procedures - As mentioned above, situations 
occasionally arise in which the Monitor must be reloaded by the boot- 
strap. If the bootstrap is intact in core, it may be restarted by 
the procedures which follow. 

a. Set the console ADDRESS switches to one of the addresses 
shown below in accordance with the maximum core size of 
the system. 

Address Maximum Core Size 

57646 24K 

77646 32K or more 

b. Press the console switches STOP and RESET; then press START. 

c. The Monitor should then identify itself as shown in 7. 3. 2.1. 

d. If the Monitor does not identify itself, the bootstrap has 
been destroyed and must be reloaded as described in 7. 3. 2.1. 


^or UC15, RK based systems, this occurs only if PIREX is running. 
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7.4 SYSTEM MODIFICATION (TAILORING) PROCEDURES 

The software package supplied to each user is a general purpose ver- 
sion of the XVM/DOS Software System. This means that the system con- 
tains all of the standard XVM/DOS language programs, utility programs, 
library routines, and I/O device handling routines supported by Digital 
Equipment Corporation. Included as a part of this general package is 
a utility program called the System Generator (or SGEN) . SGEN enables 
the user to tailor the XVM/DOS software to suit the particular hard- 
ware configuration and operating requirements of his installation. 

Specifically, SGEN provides the user with the ability to: (1) delete 

system programs or add his own 1 ; (2) add and delete I/O device hand- 
lers; (3) alter system load-time parameters such as: I/O device assign- 

ments, teleprinter model currently being used, number of buffers to be 
allocated, file and directory protection codes, etc.; (4) change system 
operating parameters including: the Priority Interrupt Skip Chain, 

number of positive .DAT slots, the presence of 7- or 9-channel Magtape 
drives, the Monitor Identification Code (MIC). The amount of disk 
cartridge utilized for spooling on UNICHANNEL systems can be altered 
by SPLGEN. 2 


Described in the XVM/DOS System Manual and the SGEN XVM Utility 

Manual . ~~ ~~ — — 

2 . 

Described in the XVM/DOS Keyboard Command Guide. 
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CHAPTER 8 
KEYBOARD COMMANDS 


8 . 1 INTRODUCTION 

This chapter describes the commands which can be issued from console 
keyboard to direct the operations of the XVM/DOS system software. In 
communicating with the Monitor/ the keyboard of the console teleprinter 
is used as the system's control device. The operator at the keyboard 
types commands to allocate system resources, load and start system and 
user-created programs, terminate program operation, and exchange in- 
formation with the Monitor. Most of the Monitor's keyboard commands 
are issued prior to loading system or user programs and are interpreted 
by the Nonresident Monitor. 

During program execution, a small set of keyboard commands is available 
for general program control. These commands are interpreted by the 
teleprinter's I/O device handler (which is part of the Resident Mon- 
itor) , and are used to control program start and restart, dumping of 
core, and the reloading of the Nonresident Monitor. Paragraph 8.11 
describes commands used during program execution. 

The console teleprinter is the communications interface between the 
user-operator and the Monitor. The interaction between the operator 
and the Nonresident Monitor is completely conversational. Each com- 
mand issued causes the Monitor to type out an appropriate reply. 

Monitor responses may vary from a single character to several pages 
of information. 

In the context of this manual, the term "console keyboard" designates 
any one of several keyboard/printer/display I/O devices which could be 
used by the Monitor as the system command console device. (That is, 
it is associated with .DAT slots -2 and -3.) 

The keyboard commands are, however, not strictly limited to input from 
the keyboard. The Monitor can be operated in a Command Batching Mode 
(see 8.12) in which keyboard commands can be issued from punched 
cards, paper tape or from a mass-storage device with minimum operator 
intervention. Similarly, the Monitor's responses to commands are not 
strictly limited to a keyboard device's printer or display, but may 
also be output to other devices including the VT15 display or a line 
printer, when available. 
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8.2 KEYBOARD COMMAND FORMATS AND CHARACTERS 
8.2.1 Keyboard Command Elements 


All Keyboard commands, except those using the keyboard CTRL key, consist 
of at least two elements, a command name and a terminator. Some com- 
mands require an additional third element consisting of one or more 
arguments inserted between the command name and the terminator. Each 
command name is separated from its argument (or argument string} by one 
or more spaces. Delimiters between multiple arguments vary, and are 
specified in the descriptions for the individual commands. Except as 
otherwise specified, each command string can be terminated by either a 
Carriage RETURN or an ALT MODE. CTRL commands are formed by simultane- 
ously depressing the keyboard's CTRL key and letter key, and are inter- 
preted by the Resident Monitor. These commands need no terminators, 
such as Carriage RETURN or ALT MODE. They are interpreted immediately 
after they have been typed. Once typed, the command is echoed in the 
form of an up-arrow (1) followed by the letter which identifies the com- 
mand. Thus, CTRL C is echoed 1C. 


The symbols defined in Section 5.2.2 are used in illustrating the com- 
mand formats described in the succeeding paragraphs of this chapter. 
XVM/DOS system programs accept ASCII characters shown in Appendix A. 


8.2.2 Editing Features 

The teleprinter's device handler provides two keyboard editing functions 
which can be used to change the line currently being typed (prior to 
typing Carriage RETURN or ALT MODE) . 


RUBOUT The RUBOUT key permits successive deletion of characters, 
starting with the last character typed. Each RUBOUT 
deletes one character and causes a backslash (\1 to be 
echoed in response. RUBOUT does not delete characters 
past the previous line terminator. Once all characters 
in a line have been deleted, additional RUBOUTS are 
ignored. For example, if the command INSTRUCT were mis- 
typed as INSTRUTC, it could be corrected by typing two 
RUBOUTs followed by CT, as shown below: 

Example : 

$ INSTRUTC \\CT 

CTRL U Formed by depressing the CTRL key and striking the U key, 
this command during input eliminates all characters typed 
up to the last Carriage RETURN or ALT MODE and echoes 
a @. Thus an irretrievably bollixed input line may be 
eliminated (before typing Carriage RETURN or ALT MODE) 

T J_ ~ rimTi t tt ml- .! _ H J 1 1 3 n • 

uy L_yp j-iiy liiuj u . nub ieaLUit; uaii aibu utJ uibtiu. uui xny 
output to abort the current line. 
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8.2.3 When to Issue Keyboard Commands 

All keyboard commands, except for the CTRL commands (see 8.11) are 
only recognized and accepted when the Nonresident Monitor is in core, 
as evidenced by the appearance of either of the following identifiers 
on the teleprinter : 

XVM/DOS Vnxnnn where: nx is the version and 

nnn is the edit number 

$ of this version, 

or 

$ 

The operator can obtain the Nonresident Monitor by typing CTRL C, (de- 
scribed in 8.11.1). When the Monitor is initialized using the Boot- 
strap, or by typing CTRL C, the full identification is typed. At all 
other times it indicates its readiness to accept keyboard commands by 
simply typing the dollar sign ($) . Once the $ is typed, the Monitor 
idles until the operator types a command. 

8.3 COMMANDS TO REQUEST SYSTEM INFORMATION 

The commands in this paragraph provide the user with various lists 
of system information. The lists include: (1) general system in- 

formation, (2) keyboard commands, (3) error messages, and (4) .DAT 
slot assignments. Since these lists tend to be lengthy, users who 
have either a line printer or a VT15 Display can speed up the output 
of this information by using the special line printer and VT15 com- 
mands (described in paragraphs 8.9 and 8.8, respectively). 

8.3.1 SCOM 

The SCOM command causes the typeout of XVM/DOS system information. 

The information includes (1) available I/O device handlers, (2) sys- 
tem default parameters, (3) important core addresses, and (4) the 
Priority Interrupt Skip Chain order. 

Form: S[C0M3^ 

In this and subsequent descriptions, characters enclosed in brackets 
are optional. 


8-3 



$API ON 



BANK MODE 64 K fiF‘1 ON XVM OFF UC15 ON POLLER OFF 
*XVM ON 

BANK MODE 64 K ftp I ON XVM ON UC15 ON POLLER OFF 

4 3COM 

SYSTEM INFO - XVM/DOS - 06/25/75 

77646 - BOOTSTRAP RESTART A DDR 

77626 - 1ST FREE CELL BELOW BOOTSTRAP 

4157- A DDR OF . DAT 

4215- AD DR OF . IJFD 

2Q - NO. OF POS. . DAT SLOTS 

API IS ENABLED 

XVM MODE IS ENABLED 

BANK MODE OPERATION 

7 CHANNEL MAGTAPE ASSUMED BY HANDLERS 
80-CHARACTER LINE PRINTER ASSUMED BY HANDLERS 

2 - DEFAULT FILE PROTECTION CODE 
4 - CURRENT FILE PROTECTION CODE 

03 - DEFAULT BUFFS SETTING 
1432- ‘G ADDRESS FOR MANUAL DUMP 
I/O HANDLERS AVAILABLE 

TTfi TELETYPE: I/O, ASCII MODES, ALL FUNCTIONS 

PR A TAPE READER: INPUT, ALL MODES, ALL FUNCTIONS 

PRE: TAPE READER: INPUT, I OPS ASCII MODE, ALL FUNCTIONS 

PPA PUNCH: OUTPUT, ALL MODES, ALL FUNCTIONS 

PPB PUNCH: OUTPUT, ALL MODES LESS I OPS ASCII, ALL FUNCTIONS 

P P C P U N C H : 0 U T P IJ T , I 0 P S B I N A R V M 0 D E , A L L. F U N C T 1 0 N S 

DTA DECT APE: 3 FILES, I/O, ALL MODES, ALL FUNCTIONS 

DTC DECTAF’E : 1 FILE, INPUT, I OPS MODES, LIM FUNCTIONS 

DTD DECT APE: 1 FILE, I/O, ALL MODES, ALL FUNCTIONS 

DTE DECTAPE: 1 FILE, I/O, ALL MODES, NO MTAPE 

DTF DECTAPE: NON-FILE ORIENTED FOR F4 . OTS 

DKA DECDISK : N FILES, I/O, ALL MODES, ALL FUNCTIONS 

DKB DECDISK: N FILES, I/O, ALL MODES, LIM FUNCTIONS 

DKC DECDISK: N FILES, INPUT, ALL MODES, LIM FUNCTIONS 

DP A DISKPACK: N FILES, I/O, ALL MODES, ALL FUNCTIONS 

DPB DISKPACK: N FILES, I/O, ALL MODES, LIM FUNCTIONS 

DPC DISKPACK: N FILES, INPUT, ALL MODES, LIM FUNCTIONS 

RKA DISKCART : N FILES, I/O, ALL MODES, ALL FUNCTIONS 

RKB DISKCART: N FILES, I/O, ALL MODES, LIM FUNCTIONS 

RkU DISKCART: N FILES, INPUT, ALL MODES, LIM FUNCTIONS 

NT A MAGTAPE: 3 FILES, I/O, ALL MODES, ALL FUNCTIONS 

MTC MAGTAPE: 1 FILE, INPUT, I OPS MODES, ALL FUNCTIONS 

MTF MAGTAPE: NON-FILE ORIENTED FOR F4 .OTS 

LPA LINE PRINTER: OUTPUT, ASCII MODES, ALL FUNCTIONS 

CDB CARD READER: INPUT, I OPS ASCII MODE, ALL FUNCTIONS 

VP A VP DISPLAY: OUTPUT, ASCII AND DUMP MODES, ALL FUNCTIONS 

VTA VT-15: I/O 

XYA PLOTTER: OUTPUT, ASCII & BINARY MODES, ALL FUNCTIONS 
L..KA LK-35 KEYBOARD: INPUT, ASCII MODES, ALL FUNCTIONS 
SKIP CHAIN ORDER 
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SPFftL 

DTDF 

DSSF 

RKSF 

DPSJ 

MTSF 

SPDI 

I4TSK 

SDDF 

CRSI 

CRSD 

l. PSF 

CLSF 

RSF 

PSF 

KSF 

KSF1 

TSF 

DTEF 

DPSE 

MF'SNE 

MF'SK 

SF'E 

CRSF 

I..SSF 

KYSF 

KSF 2 

KSF 2 

KSF 4 

KSF 5 

$ O' 

* 
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8.3.2 INSTRUCT 

The INSTRUCT command causes a typeout of either the keyboard commands 
or system errors, depending upon which form of the command is used. 
This command utilizes .DAT -12 as the output device. 

Form 1 : I [NSTRUCT] J 

XvN/DQS Vnxnnn 


■ 0 0 


COMMANDS 


LOG < i. 

) i L 

SER C 

o 

Y'i 1 

ENTS 

TEr- 

MI 

NATE 

D B '' 

f 

ALT 

MODE 


LOGW ; 

USE 

R COM 

M 


TS T 

ERM1 

Nt- 

LIED 

h Y »’ 

a 

TMC 

DEv W 

ATT FOR 

Dr) ) ( 

D > t 

ECHO 

D 











DATE 

U) MM/DD/ 

V 

Y l 

ENT 

ER I. 

A"i 

t:. 






T :i: me i 

T > j 

ECHO 

T 

1 M 










T I HE ( 

T ) F 

FI MM : 

E 

NT 

£ ]'i; J 

1 ME 








PROTI: 

L" 1 ( !•* 

> Mi 

iJ 

HA 

N (*! F 

DLi- r- 

1 ]i 

.7 PR 

OTE( 

;! 

I ON 

CODE 

TO N 

KEEP 

K ) 0 

N/OFF 

i 

K 

EEP 

, DAT 

K. 

ALOIS 

UNi 

H. 

TER 

ED ii N 

♦ EXIT 

i... J G 1 M 

UK 

y •> 

T !-, M f 

.i. 

j ; : 

N E 

: i T «-' 

C U f 

RE 

NT U 

i: c 





BOSS J 

5: !:: 

NTER 


l 

S . i. *3 

DAI t 

H 

MODE 






SC OH ( 

) l 

SYST E 

M 

T 

NFO 









INST! 

: j f; r 

I ) : i... 

T 

.«. 

ST 

OF 

nONl 

I f 

R CO 

MMAF 

IB 




INSTRUCT < 


R 

OR 

s: B 

escf 

IF 

T.ION 

OF 

E 

RRO 

H C U .0 

ES 

REQLiii: 

ST ( R 

•' r R E 

{} 

UE 

ST ( R 

) PR 

GF 

A h : 

, DA" 


SLO 

T USA 

GE 

FiEQUfc 

S T < R 

) USE 

R 


PCS I 

TIUE 


DAT 

SLOT 

U S A 

(;) j;;’ 


MODE : 

BIS 

l :: ' i... A Y 

c 

UR 

RENT 

MAC 

{••{ 1 

NE 0 

PERf- 

>T 

.TNG 

ENU I 

RONMENT 

A S S i. 

N ( A ) 

DEVN 


an cl 

A r B / 

V % 

♦ / f 

U v l 


DAT 

SLOT 

MODS 

ODUMF 

( Q ) i 

SET 

TO 

S A V E 

COR 

£ 

< ' Q ) 

ON 


TOP 

S ERR 

OR 

HAL T ( 

h ) : 

A I I 1.7 

SET T 

0 


ALT 

ON , 

K 

E 

RROF 





GET ( r. 

) 1 E 

£8 TOR 

E 



FROM 

- 

U A R 

EA 





G E T p J 

corf: 

i" Kull 


"'Q 

ARE 

A AN 

V\ 

REST 

ART 

W 

ITH 

•-•p 


GETT I 


TORE 

c 

OR 

I i :; ' R 

OM "" 

Q 

AREA 

AN I 

i 

K‘ i::. y 

TART 

WITH ”T 

GETS 

J RE 

STORE 


CG 


ROM 

•"G 

AF'E 

A AG 

!D 

RE 

START 

WITH "'S 

GET ( C- 

) N 

FILE 

•> 

R 

!:• S 1 URL C 

OF 

E FR 

0 Mi F 

r 

LE 

ON UN 

IT N AND 

GETP 

N F" I 

LE " 


IS 

TORE 

COF 

p 

FROM 

FILE 

ON 

UNIT 

N AND RE 

GETT 

N FI 

L E i 

R 

IS 

TORE 

COF 

E 

FROM 

FIL 

.E 

ON 

UNIT 

N AND RE 

GETS 

N FI 

LE i 

R 

b 

TORE 

COF 

E 

FROM 

FIL 


ON 

UN I T 

N AND RE 

PUT N 

FIL 

ENM • 


;: 'U 

r '"Q 

ARE 

A 

INTO 

FIL 

.E 

NM 

ON UNIT N 

API ON/ OF 

f: cha 

'•! u 

E ST 

ATE 

OF 

API 






0 T ON 

/OFF 

: TURN 

G 

I'AF’H 

IC i: 

IS 

PLAY 

ON/ OFF 




WITH ~P 
WITH ”T 
WITH "S 


HALF ON/ OFF l TURN HALF BUFFER MODE FOR GRAPHIC DISPLAY ON 
T A B 0 N / 0 F F I P E R F 0 R M S 0 F T W A R E E n U I... A T 1 0 N 0 F T A B K E Y * 

F I L !... 0 N / 0 F F t P R 0 V I D E F I i... L C H A R A C T E R S A F T E R C R / L F ♦ 

LF ON/ 01- 1- X \ URN ON/ OFF' LINE PRINTER FOR OUTFTJT OF SOM FI NRM COMMAND 
XVM ON/ OFF ' t RUN USER PROGRAMS WITH XM-15 OPTION, 

BANK on/off: CHANGE STATUS OF BANK MODE 

PAGE ON /OFF: CHANGE STATUS OF PAGE MODE 

buffs n: CHANGE DEFAULT BUFFER ALLOCATION 

CHANNEL 7/91 SETUP DEFAULT ASSUMPTION FOR MAGTAPE 

~C: RESTORE DOS- 15 ”P: USER RESTART '"T? RESTART DDT 

"X: TURN VT ON OR OFF 
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DOS 


P R 0 G L 0 A D I N G C 0 M M A N D S A N D P R 0 G N A M F 0 R 
LOAD i LINK LOAD AND WAIT FOR "S GLOAD 
GLOADI LINK LOAD AND GO 


REQUEST COMMAND 
%' / 


DDT: LINK LOAD WITH SYMBOLS AND GO TO DDT 

DDT NS : LINK LOAD W/O SYMBOLS AND GO TO DDT 

MACRO J MACRO ASSEMBLER 

F 4 : F 0 R T R A N I V C 0 M P I L. E R 

EDIT: TEXT EDITOR 

PIP : PERIPHERAL INTERCHANGE PROG 

dump: bulk stor dev dump 
update: libr file update 

S R C C 0 M : S U U R C C 0 M A R E 

ED I tup: STORAGE SCOPE EDITOR 

editvt: graphic display <vr> editor 
patch: system tape patch routine 

EXECUTE ( E ) FILE: LOAD AND RUN FILE XGT 
C H A I N : X C T C H A I N B IJ I L D E R 
8 T R A N <■ P D P - 8 T 0 P 0 P - 1 5 T R A N S L A T 0 R 

mtdump: mag-tape utility program 

DOS- 15 : BATCH 

B a T C H < B > D V i: U N < U I C > F I i... N A M 1 

DU: ANY VALID XVM/DOS DEVICE WHICH SUPPORTS INPUT 
PLUS •' SY •' MEANING THE CURRENT SYSTEM DEVICE ♦ 
UN: UNIT NUMBER 


U I C : U S E R I D E N T I F I C A T 1 0 N C 0 D E 

FILNAM: a FILE NAME WITH THE REQUIRED EXTENSION 'BAT' 
$ JOB i CONTROL COMMAND WHICH SEPARATES JOBS 


* D A T A : B E G I N N I N G 0 F“ D A T A 
$END: END OF DATA 

$pause: wait for ~r on tty 

$ E X I T : L E A V E B A T C H M 0 D E 

"t: skip to next job 

"C: LEAVE BATCH MODE 
R I C O N T I N U E F r R 0 M $ P A U S$ E 


XV M/D OS Vnxr.nn 
ii> 
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Form 2 : 

Example 

XU M/DOS 
$1 ERR OF 
DOS-- .1.5 •• 


I [nstruct] ^ERROR IXIY 


Vnxnnn 


I OPS i 


0 ILL FUNCTION CAL ■••• CAL A DDR 

1 CAL* ILL - CAL A DDR 

2 r DAT SLOT ERROR - CAL A DDR 

3 ILL INTERRUPT - I/O STATUS REGISTER 

4 DEV NOT READY TYPE "'R WHEN READY * 

5 ILL ♦ SETUP CAL - CAL ADDR 

6 ILL HANDLER FUNCTION - CAL ADDR * 

7 ILL DATA MODE - CAL ADDR * 

10 FILE STILL ACTIVE - CAL ADDR ** 

1.1. SEEK/ENTER/INIT NOT EXECUTED CAL ADDR * 

12 UNRECOVERABLE DEVICE ERROR •••• STATUS REG B AND UNIT NO ♦ 

13 FILE NOT FOUND •••• CAL ADDR ** 

14 DIRECTORY FULL - CAL ADDR 

15 DEVICE FULL CAL ADDR ** 


16 

17 

20 

21 

22 

23 

24 


27 

30 

31 

32 

33 

34 


37 

40 

41 

42 

43 

44 

45 

46 

47 
51 
5 5 
6 1 

63 

64 

65 

66 
67 

70 

7.1 


OUTPUT BUFFER OVERFLOW - CAL ADDR 
TOO MANY FILES FOR HANDLER ~ CAL ADDR ■¥ 

DISK FAILURE <"'R TO RETRY) - DISK STATUS v BLK # ? DEVICE/UNIT # v CAI. 

ILL DISK ADDR - BLOCK NO* DEV ICE/UN IT NO ? CAL FUNCTI ONvUIC 

TWO OUTPUT FILES ON ONE DEC TAPE UNIT - CAL ADDR 

OUTPUT BUFFER OVERFLOW •••• CAL ADDR 

ILL UNIT NUMBER - CAL ADDR 

NEGATIVE OR 0 CHARACTER COUNT (.TOPS ASCII WRITE) 

X OR Y INCREMENT TOO LARGE 02**14) (BINARY WRITE) 

ILLEGAL WRITE TYPE 

API SOFTWARE LEVEL ERROR API STATUS REG 
NON-EXISTENT MEMORY REF - PC 
MEMORY PROTECT VIOLATION - PC 
MEMORY PARITY ERROR - PC 
POWER FAIL SKIP NOT SETUP - PC 

CONTROL CHARACTER TYPED WHEN RECOVERY NOT POSSIBLE 

- CONTROL CHARACTER ROUTINE ADDRESS 

LINE OVFLO - CAL ADDR 

HEADER LABEL ERROR - CAL ADDR 

DIRECTORY FORMAT ERROR - CAL ADDR 

ACCESSIBILITY MAP OVFLO -• CAL ADDR 

DIRECTORY RECORDING ERROR - CAL ADDR 

LOGICAL EOT FOUND - CAL ADDR 

LONG INPUT RECORD - CAL ADDR 

ATTEMPT TO DELETE SYSTEM. FILE - CAL ADDR 

ILL HORIZONTAL TAB - CAL ADDR 

ILLEGAL USER FILE DIRECTORY - CAL ADDR ** 

NO BUFFERS/TCB AVAILABLE - CAL ADDR * 

PARITY ERROR IN DIRECTORY OR FILE BIT MAP - CAL ADDR * 

PROTECTED USER FILE DIRECTORY -- CAL ADDR * 

PROTECTED FILE -- CAL ADDR ** 

UNRECOVERABLE M A G T A P E / T E L. E C 0 M U N I CATIONS ERROR - STATUS WORD 
RELATIVE BLOCK IS 0 OR NOT WITHIN FILE SCOPE ( * RTRAN ) ** 

I/O BUFFER LOCATED ABOVE 32K BOUNDARY •••• CAL ADDR 
* RTRAN ARGUMENTS CAUSE DATA BLOCK OVERFLOW - CAL ADDR ** 

BUFFER SIZE TOO SMALL - CAL ADDR * 

EMPTY UIC ** 
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UC ••••15 E 
WHERE 7 


AND INN- 


LOADER 


INPUT PARITY OR WRITE! CHECK ERROR < R TO RETRY) 

C A L A D D k ? B L. 0 U K N 0 ? D E V 1 C E / U N I T N 0 ? C A L.. F U N C T 1 0 N ? U I C 
NULL F I LE NAME G I MEN ON SEEK/ENTER/DLETE/FSTAT/RAND 
TRUCTURE 


7 4 F I !... E S T R U C T U R E D E G R A D A 1 1 0 N 
BIT THAT WAS ALREADY OFF W 

75 F I LE STRUCTURE DEGRADAT I ON 

76 FILE STRUCTURE DEGRADATION 
MFD OR UFD BLOCK <""R TO RET 


ATTEMPT TO CLEAR SUBMAF 


ILLEGAL 

ILLEGAL 


SUBMAP WORD! 
BACKWARD POINTS! 


A T T E M P T E D Li S E 0 F N 0 N •••• E X I S T A N T "" Q A R !:: 


t DISK ONLY i 

CAL ADDRy DEVICE! AND UNIT NO, ? CAL. FUNCTION? U I 
YY DISK ONLY! 

CAL ABDRy DEVICE AND UNIT NO,? CAL FUNCTION ? U I 

R k 0 R M E S S A G E S 

FORM t IOPSUC TSK ##* 

SK IS ONE OF THE FOLLOWING $ 

EST STOP I/O TASK 


ESD 


SOFT WAR! 

! DRIVER 



RKU 


DISK CA! 

rr ridge 



DTU 


DEC TAPE 




LPU 


LINE pr: 

INTER 



CDU 


CARD REr 

UJER 



PI...U 


X-Y PL O' 

"TER 



ESP 


SPOOLER 




I::.Mr 

PRX 


n AL- .1. .1. 
POLLER 




LVU 


LV-ll El 

..EC 7' ROST ATI 

C PRINTER- 

'PLOTTER 

IS 

ONE 

OF THE 1 

HOLLOWING t 



3 

□...LEGAL INTEI 

iRUPT TO DR 

IVER 


4 

DEVI t 

E NOT Rl 

!ADY 



1 2 

DEVK 

E FAILUI 

it 



15 

SPOOL 

ER DISK 

AREA FULL 



2 0 

SPOOL 

ER DISK 

FAILURE 



25 

XY PL 

OTTER •••• 

VALUE TOO 

LARGE FOR 

PLOTTING 

26 

SPOOLER term: 

MATED UNEX 

PECTEDLY 


27 

XY PL 

OTTER - 

INCORRECT 

MODE 


45 

SEE A 7 

ER THAN 

80 COLUMNS 

IN CARD 



5 5 N 0 S P 0 0 L E R B U F F E R S A V A I !... A B L E 
72 ILLEGAL PUNCH COMBINATION 

74 TIMING ERROR ~ CARD COLUMN LOST •••• RETRY CARD 

75 HARDWARE BUSY - DRIVER NOT BUSY 

76 HARDWARE ERROR BETWEEN CARDS 

77 UNRECOGNIZED TASK REQUEST 
200 NON-EX I ST ANT TASK REFERENCED 
300 ILLEGAL API LEVEL GIVEN, 

400 SPOOLER EMPTY -• POP- 15 INPUT REQUEST PENDING 
ILLEGAL DIRECTIVE CODE GIVEN 
500 NO FREE CORE IN PDF -11 LOCAL MEMORY 

600 ATI... NODE FOR THIS TCN MISSING 

601 FREE CORE MAP FOR LOCAL MEMORY IS BAD 


602 TCB ADDRESS GREATER THAN 28K 
777 REQUEST NODE WAS NOT AVAILABLE 
ERRORS - , LOAD OR , SYSLD 


1 MEMORY OVERFLOW 

2 DATA ERROR 

3 SUBR NOT FOUND 

4 , DAT SLOT ASSIGNMENT ERROR 

5 PROG SEGMENT GREATER THAN 4K (PAGE MODE) 

6 COMMON BLOCK LENGTH GREATER THAN 32K--1 WORDS 

7 RELOCATED VALUE OF SYMBOL GREATER THAN 32K-1 

8 ATTEMPT TO INITIALIZE A LOCATION OUTSIDE THE 
RANGE OF THE CURRENT PROGRAM OR COMMON BLOCK 

9 WARNING — MORE THAN ONE HANDLER LOADED FOR 
A DEVICE? THE LOADING PROCESS CONTINUES 
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OBJECT TIME SYSTEM ERRORS - .OTS 

5 ILL REAL SQUARE ROOT ARG 

6 ILL DOUBLE SQUARE ROOT ARG 

7 ILL INDEX IN COMPUTED GOTO 

10 ILL I/O DEV 'll- 

11 ILL INPUT DATA 

12 ILL FORMAT STATEMENT 

13 ILL REAL LOG ARG 

14 ILL DOUBLE LOG ARG 

15 ZERO RAISED TO ZERO OR NEGATIVE POWER 

16 ATAN2(0*0»0*0) 

1 7 D A T A N 2 < 0 <• 0 0 0 y 0 , 0 0 0 ) 

21 UNDEFINED FILE 

22 ILLEGAL RECORD SIZE 

23 S I ZE D I SCREP ANC Y 

24 TOO MANY RECORDS OR ILLEGAL RECORD # 

2 5 M 0 D E D I S C R E P A N C Y 

26 TOO MANY OPEN FILES 

30 SINGLE INTEGER OVERFLOW 

31 EXTENDED C DOUBLE) INTEGER OVERFLOW 

32 SINGLE FLT* OVERFLOW 

3 3 D 0 U B L E F L T * 0 V E R F L 0 W 
3 4 S I N G L E l :: ' !... T * U N D E R F I... 0 W 
3 5 D 0 U B I... E F i... T <• U N D E R F L 0 W 
36 FLT. DIVIDE CHECK 

3 7 I N T E G E R D I V I D E C H E C K 

4 0 I i... I... E G A !.. C H A R A C T E R C 0 U N T 

41 ARRAY EXCEEDED 

42 BAD INPUT DATA 

50 FPP MEMORY PROTECT/NON-EX I ST ANT MEMORY VIOLATION 

51 ILLEGAL I/O DIRECTION CHANGE TO DISK 


XV M/DOS Vnxnnn 
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8.3.3 REQUEST 

The REQUEST command causes a typeout of the I/O Device Handlers cur- 
rently associated with the slots of the Monitor's Device Assignment 
Table (.DAT). Since this command is closely related to the commands 
which affect I/O device assignments, it is described in paragraph 8.5.1. 

8.3.4 MODE 


The MODE command causes the typeout of the following mode specifica- 
tion message. This mode specification message is also output imme- 
diately after the date is entered; and after any relevant mode changes. 


nnnK 


[BANK] 

[API 

ON ] 

l r 

IpageJ 

[API 

off] 

1 


POLLER ON 
POLLER OFF. 


UCl 5 ON 1 


[ XVM ON 1 

.UC15 OFF J _ 


[ XVM OFFJ 


uic 


where: 


nnK 


BANK 

PAGE 

(API ON 1 
[API OFFJ 

{UC1 5 ON 1 
[UC15 OFFJ 

[POLLER ON 1 
[POLLER OFFJ 

[XVM ON 1 
IXVM OFFJ 


uic 


always appears and "nnn" is the current memory 
size (MEMSIZ) . 

appears whenever the system is in bank mode. 

appears whenever the system is in page mode. 

appears whenever the API hardware is present and 
enabled (ON) or disabled (OFF) . 

appears whenever the UC15 peripheral processor is 
present and its use is enabled (ON) or disabled (OFF) . 

appears whenever the UC15 peripheral processor is 
present and the poller is enabled (ON) or disabled 
(OFF) . 

appears whenever the XM15 hardware option is pre- 
sent and wide addressing is enabled (ON) or dis- 
abled (OFF) . 

is the User Identification Code. 


8.4 COMMANDS RELATED TO FILE PROTECTION 


8.4.1 LOGIN 


This command permits the operator to enter his User Identification 
Code (UIC) into the system in order to do directoried disk I/O. After 
a LOGIN, the Nonresident Monitor sets the slots of the User File Direc- 
tory Table (UFDT) to the three-character code entered. All input/ 
output operations to the disk are directed to the UFD associated with 
the last UIC entered by this command, unless a program has subsequently 
executed a .USER I/O Macro, or the operator has issued an ASSIGN com- 
mand (see 8.5.2) . 
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Each LOGIN command issued enters a new UIC into the system and auto - 
matically deletes the one entered previously. Each LOGIN is an im- 
plicit LOGOUT (see LOGOUT, in paragraph 8.4.4). A UIC must consist 
of exactly three alphanumeric characters in any combination except 
, "???", "PAG", "BNK" , "SYS", "IOS" and "CTP". 

Form: LOGIN, .uic^ 

where: uic = User Identification Code 

8.4.2 MICLOG 

This command permits the Monitor Identification Code (MIC) to be en- 
tered into the system. This provides the operator with unrestricted 
access to all files contained in the various directories on the disk 
and permits the system programs SPLGEN 1 , SGEN and PATCH to be used to 
modify the system. The MIC of each system, as initially supplied to 
the user, is "SYS". As with LOGIN, a MICLOG entry is deleted from the 
system by the LOGOUT or LOGIN commands. The MIC is usually known only 
by the system owner, and the code is easily changed at system generation. 

Form: MICLOG|_»mic 4 ) 

where: mic = Monitor Identification Code 

8.4.3 PROTECT 

The PROTECT command is used to alter the default value of the file 
protection code, set when the system was generated (by the SGEN 
program) . The default file protection codes set by this command 
remain in effect until another PROTECT command is given or until the 
user issues a LOGIN or LOGOUT (which resets the protection code to 
the system's default value). Refer to 4.7.3 for a list of these codes. 

Form: P [ROTECTj | __ | n ^ 

where: n = Protection Code 

8.4.4 LOGOUT 

This command deletes the current UIC or MIC entry from the system. 

LOGOUT also resets all system parameters affected by keyboard commands 
to their default status. These parameters include: 

^UC15 Systems only. 
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a. .DAT and .UFDT assignments (ASSIGN command) 

b. Commands which take an "ON/OFF" argument, such as: 
KEEP, FILL, TAB, HALF, LP, PAGE/BANK, API, and VT. 

c. Commands which take a numeric argument, including: 
CHANNEL, PROTECT, and BUFFS. 

Form: LOGOUT j 

8.5 COMMANDS DEALING WITH I/O DEVICE ASSIGNMENTS 


8.5.1 REQUEST 


This command causes a typeout of the I/O devices currently associated 
with the slots of the Monitor's Device Assignment Table (.DAT) and 
the UIC ‘ s associated with the User File Directory Table (.UFDT). The 
command can be issued using various arguments which result in a complete 
printout of the assignments or selected portions thereof. If REQUEST 
is issued with no argument, the entire .DAT/. UFDT list of assign- 
ments is output. If the argument USER is inserted, only the positive 
(user) .DAT and associated .UFDT assignments are output. If an argu- 
ment which is a legal system program name is used (e.g., MACRO, PIP, 
etc.), only the assignments for that program are output. 

[ user! 
or 

prog J 

"prog" may be any of the following: 


MACRO 

UPDATE 

CHAIN 

F4 

PIP 

EXECUTE 

FOCAL 

^MACll 

8 TRAN 

PATCH 

2 SPOOL 

DDT 

DTCOPY 

EDIT 

DDTNS 

GLOAD 

EDITVP 

BOSS 

LOAD 

EDITVT 

1 SPLGEN 

DUMP 

SGEN 

1 SPLOAD 

MTDUMP 

SRCCOM 



Example 1 : 


$R 




, DAT 

device: uic 

- 1 5 

SYA SCR 

- 1 4 

SY A SCR 

~ 1 3 

SYA SCR 

- 1 2 

LPA SCR 


\ Unichannel- 15 systems only. 

2 Only for RK based UC15 systems. 
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•••■ i i 

SYA 

f; ft 

- 1 0 

cmd 

SCR 

7 

RKL 

Cj Y C; 

”” £> 

SYA 

SCR 

*“ vJ 

NON 

SCR 


SYA 

SCR 

- 3 

IT A 

SCR 

— • 2 

CMD 

SCR 

- 1 

S Y A 

SYS 

T 1 

SYA 

SCR 

+2 

8 Y A 

s C R 

+ 3 

SYA 

SCR 

+ 4 

IT A 

SCR 

+ 5 

PR A 

SCR 

•f 6 

LPA 

SCR 

+ 7 

DP A 

3 C R 

+ 10 

DP A 

SCR 

+ 1 1 

DTA 

SCR 

+ 12 

DTA 

SCR 

+ 1 3 

PPA 

SCR 

+ 1 4 

NON 

SCR 

+ :i. 5 

NON 

SCR 

+ 1 6 

NON 

S C R 

+ 17 

NON 

SCR 

+ 20 

NON 

SCR 


* 


Example 2 : 

*R USER 


♦ DAT 

DEVICE 

UIC 

+ 1 

SYA 

SCR 

+ 2 

SYA 

SCR 

+ 3 

SYA 

SCR 

14 

IT A 

SCR 

+ 5 

PR A 

SCR 

+ 6 

LPA 

SCR 

+ 7 

DP A 

SCR 

+ 3. 0 

DP A 

SCR 

+ 11 

DTA 

SCR 

+ 12 

DTA 

SCR 

+ 1 3 

PPA 

SCR 

+ 3. 4 

NON 

SCR 

+ 15 

NON 

SCR 

+ 1 6 

NON 

SCR 

+ 1 7 

NON 

SCR 

+ 20 

NON 

SCR 


$ 

Example 3 : 


$R MACR 

J 



♦ DAT 

DEVICE 

UIC 

USE 

-14 

SYA 

SCR 

INPUT 

-13 

SYA 

SCR 

OUTPUT 

-12 

LPA 

SCR 

LISTING 

- 3. 1 

SYA 

S C R 

INPUT 

.... J_A 

CMD 

SCR 

SECONDARY INPUT 

.... 1 

Q V A 

SYS 

3 y S T EM M A C R Q F I 


$ 
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8.5.2 ASSIGN 


This command permits the temporary reassignment of the various slots 
of the Monitor's Device Assignment Table (.DAT) to I/O device handlers 
other than those permanently assigned at system generation. In addi- 
tion, the corresponding slots of the User File Directory Table (.UFDT) 
can also be reassigned to UIC's other than the UIC which is currently 
in effect. Unless the KEEP command is issued, the change of assign- 
ment is effective only for the current job (i.e., the program about to 
be run) , since the permanent assignments are restored when the Nonresi- 
dent Monitor regains control (i.e., after the current job has terminated). 
The KEEP command (described below) can be used to retain assignments 
from job to job. 


Prior to using ASSIGN, the user should be familiar with the various 
handlers which can be used with the program for which the assignments 
are to be made. Chapter 9 describes the handlers in the system. A 
list of the handlers available on any given system can be obtained in 
the printout obtained with the SCOM command. The following rules should 
be observed when typing ASSIGN commands: 


a. Device handler names consist of three characters which 

can be abbreviated to two characters if the last char- 
acter is an "A". Thus, "DKA" becomes "DK". In addi- 
tion, a number can be typed as a fourth character to 
specify the device unit number (in octal) . The unit 
number is applicable for devices which can have more 
than one unit: Disk Pack, Disk Cartridge, DECtape, 

and Magtape. If the unit number is zero, it need not 
be specified. Thus, "DTA0" becomes simply "DT" , sim- 
ilarly, "DPB0" can be typed as "DPB". " DTAl" may be 
typed as "DTI". 

b. .DAT/. UFDT slot numbers (octal) must be within the legal 
range for the particular system being used. Since the 
number of negative slots does not change (-15 is the 
lowest negative slot) , the user need only be concerned 
with the number of positive slots available. This can 
be determined either from a SCOM or a REQUEST USER com- 
mand . 

c. A series of assignments can be typed on the same line, 
using a single ASSIGN command, by separating the as- 
signments with a slash (/) . The user can then type 
another device name, UIC, and slot number (s). (See 
examples below.) 

d. Assigning NON instead of a device handler name will 
assign a null handler to .DAT slots that are not 
needed. This will save core since no handler will 
be loaded at run time. 
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e. The pseudo-device 1 SY ' (or ' SYA * or 'SYS', all equivalent) 
may be assigned. The actual handler used will be that 

of the system resident disk type (i.e., RK, RP , or DK) . 

f. The pseudo-device 'CM' (or 'CMA' or 'CMD', all equivalent) 
may be assigned. The actual device used will be the 
Batch device/command file in Batch mode, the BOSS Run 
Time File if in BOSS mode, or TTA if in neither. 


g. Two pseudo-device handler names are available and may be speci- 
field instead of a device handler name. 'SY' is a pseudo-device 
meaning 'the system- resident disk type'. In other words, if a 
system is RP02-based, SY is equivalent to using DP. Unit numbers 
and uic specifications may be used as with a disk name, but a 
handler version (A,B,C,etc.) may not be used. 'CM' is a pseudo- 
device meaning 'the command device'. This pseudo-device is de- 
signed for use with the Monitor Command Batch facility (see 
Section 8.12). Input from the CM pseudo-device is equivalent 
to the console terminal (TT) device if the system is not in batch 
mode, or the batch input device or file if the system is in batch 
mode. Output a .DAT slot assigned to CM to equivalent to the 
console terminal printer (TT) device. 


Form: 


A [SSIGN] i_j)dev 
Jdev 
(NON 


<uic> 

<uic> 


i a [, b, c , etc . V 


where: 

uic = legal User Identification Code 

dev = Device Handler name and unit (if applicable) 

a,b,c,etc. = Legal slot numbers 

NON = No device handler 


Examples : 

1. To assign the teleprinter to .DAT slot -11 and the paper 
tape reader (version A) to .DAT slot 14, type: 

AujTTu-llJ 

A. .PR. .1 

or 

A I __|TT I __,-1 1 / PR l _jl4 - ^ 

2. To assign UFD "ABC" to .UFDT slot -14, and the Disk Pack and 
UFD "TRE" to . UFDT slot 10 type: 

A,__,<ABC>i_j- 14 / DPi_ J <TRE> l _ l ljZL/ 

3. To assign the Disk Pack to several .DAT slots, type: 

AujDPujI, 2,3, 15^ 


8-16 



Keyboard Commands 


8.5.3 KEEP ON/OFF 

This command instructs the Monitor either to retain or reset .DAT/ 

. UFDT slot assignments after the current program (for which the assign- 
ments were made) terminates execution and control returns to the 

Monitor. "ON" retains assignments and "OFF" allows them to be reset. 
When a LOGOUT command is issued, the "OFF" parameter is automatically 
set . 

(°N \ , 

Form: K [EEP] 1 _ 1 | opp p 

8.6 CORE ALLOCATION COMMANDS 

8.6.1 BUFFS 

This command temporarily changes the parameter which specifies the 
default value for the number of buffers available in the Monitor's 
buffer pool for disk I/O and for the . GVBUF and . GTBUF Monitor Com- 
mands. The default value is restored whenever the Nonresident Monitor 
returns. This value is set during system generation along with the 
actual size of the buffers to be allocated (the default values for 
systems as initially distributed are: Number of Buffers = 3, Buffer 

Size = 500 q ) . 

The user should exercise care when issuing this command, since the 
Disk device handlers and the DECtape "A" handler obtain the buffers 
as required for each opened file, and terminal errors result when an 
insufficient number of buffers is available. Alternatively, program 
loading errors occur when the number of buffers allocated results 
in an insufficient amount of core for program loading. When request- 
ing system programs, the user need not be concerned about buffer 
availability since each system program has its own default parameter 
for the maximum number of buffers required (e.g., MACRO has 4, EDIT 
has 4) . 

Form: BUFFSun^ 

where: n = number of buffers (decimal radix) desired. 
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Table 8-1 

SYSTEM PROGRAM LOADING COMMANDS 


Command 

Program Loaded 

F4 

FORTRAN IV compiler. 

MACRO 

MACRO XVM Assembler. 

*MAC11 

MACH Assembler. 

EDIT 

Symbolic Text Editor. 

EDITVP 

Symbolic Text Editor for the VP15A Display. 

EDITVT 

Symbolic Text Editor for the Graphic-15 System. 

LOAD 

Linking Loader (manual program start) 

GLOAD 

Linking Loader (load and go program start) 

PIP 

Peripheral Interchange Program. 

DDT 

Dynamic Debugging Technique Program 

DDTNS 

DDT program with no user symbol table loaded (i.e,, 
octal number debugging) . 

DUMP 

Program to create listing of the contents of the 
QAREA (see 8.7). 

CHAIN 

Program to create a system of core overlays. 

E [XECUTE ] 

Control program which supervises core residency during 
execution of a CHAIN-built overlay system. 

SRCCOM 

Source Compare Program (for comparing two ASCII files) . 

MTDUMP 

Magtape user's utility program. 

SGFN 1 

System Generator Program. 

PATCH 2 

Mass Storage Patching Program. 

*SPLOAD 

SPOOLER Installation Program. 

*MCLOAD 

MAC 11 Installation Program. 

*SPOOL 

SPOOLER Control Program. 

*SPLGEN 1 

SPOOLER Disk Area Generator. 

UPDATE 

Program to create and update library files. 

8 TRAN 

Program to translate PDP-3 assembly code to XVM 
assembly code. 


1 This program can only be run when the user is logged-in to the 
system with the MICLOG command. 

2 

When this program is used with the system device, the user must be 
logged-in under the MIC. 

* 

T TXT *T~ /"1TTTI MUT-nr 1 1“ l .... _..-l 

u in x in ibi-j — 1 d t>yfc>T:eni oniy . 
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8.6.2 XVM ON/OFF 

This command is used to turn XVM mode on or off, which affects the 
amount of memory available for loading user programs. 


Form: XVM«— i 0N 

OFF 


XVM mode requires the presence of the XM15 hardware option. If this 
option is not present when the "XVM ON" command is given, the follow- 
ing message is output: 

XVM NOT AVAILABLE 

When XVM mode is disabled, the effective top of memory which can be 
used is the address of the system bootstrap. When XVM mode is enabled, 
user program COMMON blocks are permitted to reside in memory above the 
system bootstrap. The setting of this parameter does not effect the 
"MEMSIZ" parameters (paragraph 8.6.3). Whenever the XVM ON/OFF com- 
mand is given, a mode specification message is output as described in 
Section 8.3.4. 

8.6.3 MEMSIZ 

This command is used to set the current system memory size. 

Form: MEMSIZ. .numK *) 

where "num" is a decimal number in the range from 24K through 128K in 
8K increments. This command attempts to set the system memory size 
to the value entered. The memory size may not be set lower than the 
bootstrap address. If "num" is less than the bootstrap address or if 
the XM1 5 hardware option is not present, "MEMSIZ" is set to the boot- 
strap address and the following message is output: 

nnK NOT AVAILABLE — MEMORY SIZE=mmmk 

where "nnnk" is the requested memory size and. 

"mmmK" is the actual (physical) memory size or bootstrap address 

The above message is also output whenever the requested memory size 
exceeds the actual memory size. "MEMSIZ" is then set to the actual 
memory size. 
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Whenever the MEMSIZ command is given, a mode specification message is 
output as described in Section 8.3.4. 

8.7 CORE IMAGE SAVE/RESTORE COMMANDS 

The commands described in this section provide facilities for saving 
and restoring the entire image of core. These commands can be used to 
advantage not only for obtaining "snapshots" of core for debugging pur- 
poses, but also for rapid loading of commonly used programs, particularly 
user-created programs which use many library routines. 

These commands work in conjunction with a reserved area on the DECdisk 
and each Disk Pack or cartridge called the Save Area, or QAREA. The 
QAREA is a temporary storage area into which a core image may be dumped 
and from which core images are restored. This is considered a temporary 
storage area since each time a command to dump core is given, the 
previous contents of this area are lost. Additional commands are 
therefore supplied, to permit users to create named files of core 
images in the QAREA. Such files can be used for permanent storage 
and can be restored to core via Keyboard commands. The DUMP program 
can be used to obtain listings of core dumped into the QAREA. 

8.7.1 CTRL Q 

This command interrupts the program currently running, dumps the con- 
tents of core into the QAREA of the system device and returns control 
to the Nonresident Monitor. The tQ function dumps the minimum of the 
+Q area size and the current system memory size. The command is 
typed by simultaneously depressing the CTRL and Q keys on the keyboard. 
Upon receipt of the command, the Monitor echoes a tQ. (If no echo 
occurs, no QAREA exists on the device, or the system has crashed.) 

After the tQ is echoed, core is dumped into the QAREA and the Monitor 
regains control as shown below. 

Form: CTRL Q 

Response: tQ 

XVM/DOS Vnxnnn 

$ 
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8.7.2 QDUMP 

This command instructs the Monitor to automatically execute a CTRL Q 
command (see above) when a terminal IOPS error is detected. IOPS 
errors are listed in Appendix D. 

Form: q[dump] 

8.7.3 PUT 

This command instructs the Nonresident Monitor to create a file on 
the device associated with .DAT slot -14. The file is a copy of the 
contents of the +Q area on this system device (unit 0 ) . The size of 
the file is equal to the minimum of the +Q area size and the current 
system memory size. This value is kept in .SCOM, and will be stored 
in the file (as part of .SCOM in the core image) for use by GET and 
.GET. The user must type a file name which may consist of up to six 
characters and a three character extension. 

Form: PUT|_jf ilnam^ext J 

where : 

filnam = File Name (1-6 characters) 

ext = Required filename extension (1-3 characters) 

8.7.4 GET 

This command instructs the Monitor to restore (to core) a core image 
residing either in the QAREA of the system device, or on the device 
associated with .DAT slot -14 as a named file (i.e., created by a PUT 
command) . No name with the command gives the first option. If the 
user supplies a name, the second option (.DAT -14) will be taken. 

The GET command determines the size of the image by examining the copy 
of the register in the .SCOM register in the image. If the image size 
is larger than either the size of the fQ area or the current system 
memory size, the following question is asked: 

IMAGE TOO LARGE - CONTINUE (Y/N) ? 

If the reply is "N", control is returned to the Nonresident Monitor. 

If the reply is "Y", the minimum of the +Q area size and the current 
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system memory size is copied into the tQ area and into memory. If the 
image size is smaller or equal to both the tQ area size and the current 
memory size, the image will be copied into the tQ area and into memory. 

Execution of the restored core image is resumed by one of the Program 
Start/Restart Commands described in Paragraph 8.11 (CTRL P, CTRL T, 
or CTRL S) . These commands can be issued either manually from the key- 
board or automatically by argument in the GET command string. 


When a restored core image is to be restarted 
manually (i.e., by typing CTRL P, CTRL T, or 
CTRL S) , the user should wait at least 8 sec- 
onds after issuing the GET to ensure the com- 
plete transfer of the core image before typing 
the command . 


When restoring a core image file from .DAT -14, the Monitor also places 
the core image in the QAREA of the system device unit 0 . This permits 
the user to conveniently use the DUMP program to obtain listings of 
core image files. 

( p ) 

Form: GET [ ! T ] [i_jf ilnanu_jext] 

< s ! 

where: 

P , T , S = Perform automatic program start 

P = CTRL P start address 
T = CTRL T start address 
S = CTRL S start address 

Note that there must be no space between GET 
and P, T, or S. 

If not specified, the appropriate CTRL char- 
acter must be issued from the keyboard. 

filnam ext = Name and extension of core image to be re- 
trieved from .DAT -14. If not specified 
the contents of the QAREA are restored. 


NOTE 

All system conditions and parameters extant 
when core was dumped are restored. This 
includes the DATE and TIME . SCOM registers. 
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Examples : 

1. Restore the QAREA: 

type : GET A 

or Gy 

2. Restore a core image file called DMPFIL 001 and automatically 
start at the CTRL P address: 

type: GETPujDMPFILuJ^lV 

3. Restore a core image file called DMPFIL 002 to the QAREA: 

type: GET t _,DMPFIL t _ J 002y l 

Notice that a manual start must be performed, since P, T or 
S was not specified with the GET. 

8.8 VTl 5 DISPLAY COMMANDS 

The commands described in this section provide users who have config- 
urations which include a VTl 5 Display Processor and a VTJ04 Display Con- 
sole with the ability to display any text normally directed to the 
teleprinter on the screen of the VT04 Display Console. The control 
commands are issued from the teleprinter keyboard and permit rapid 
switching between hard and soft copy output when operating with either 
the Monitor, system programs, or user programs. Up to fifty-six 72- 
character lines can be displayed. Keyboard input is echoed both on 
the display (when ON) and the teleprinter. When operated in this 
manner, the VT15/VT04 Display System functions as an extension of the 
teleprinter and communicates directly with its device handler.^ - 

8.8.1 Operating Features 

8. 8. 1.1 Display Modes - Two modes of display are provided which are 
controlled by the two rightmost pushbuttons (#5 and #6) on the VT04 
console . 


"'"To operate the display as a separate I/O device, the user must use 
the software package described in VTl 5 XVM Graphics Software Manual. 
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a. Continuous (Scroll) Mode - In this mode of operation, 
pushbutton #5 must be in the OFF position (i.e., not 
illuminated) . Each text line is displayed on the 
screen starting at the top and progressing to the 
bottom. When 56 lines have been displayed, or the 
display buffer is full (as with HALF ON), each addi- 
tional line causes all displayed lines to move up 
one line position and the top line to be deleted. 

b. Paging Mode - This mode of operation causes the dis- 
play to stop after 56 lines have been output, or 
the display buffer is full. The display will then 
wait for the user's signal. Paging Mode is entered 
by setting pushbutton #5 to the ON position (i.e., 
button #5 is illuminated) . The next display page is 
obtained by depressing pushbutton #6 once. 


8. 8.1. 2 Clearing the Display Screen - The display screen can be 
erased at any time by depressing pushbutton #6 once and typing a 
Carriage RETURN. 

8. 8.1.3 Editing - Both single characters and entire lines can be 
deleted during input from the teleprinter keyboard using the standard 
keyboard editing commands RUBOUT and CTRL U. The only difference on 
the VT is that, when using RUBOUT, no backslash ( \ ) is echoed on 
the display; the unwanted character is simply deleted. 

8.8.2 Display Command Descriptions 

The following paragraphs describe the three keyboard commands required 
for operating the display. 

8. 8.2.1 VT ON/OFF - The ON argument of this command instructs the 
Monitor to load the routines which interface the VT15 to the tele- 
printer's device handler and set up the display buffer to the size 
specified by the HALF ON/OFF command (or its default setting). After 
this command has been typed, the user can switch at will between 
teleprinter and VT15 output using the CTRL X command described below. 
The routines and buffer space for display operation occupy approxi- 
mately 1300.^0 locations (when HALF is on) or 2000 ^ locations (when 
HALF is off) . The OFF argument of this command erases the display 
screen and releases the core area occupied by the display routines 
and display buffer. 

Form: VTLi™}J 
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8. 8. 2. 2 HALF ON/OFF - This command is used to set the size of the 
display buffer. This, in turn, limits the maximum number of charac- 
ters which can be displayed on the VTJ34 screen. The QFF argument 
permits a full size buffer to be created. The full size buffer allows 

4032. „ characters to be displayed (i.e., fifty-six 72-character lines). 
1J3 

The ON argument allows only a half size display buffer to be loaded. 

A half size buffer allows 2016 characters to be displayed (e.g., 28 
72-character lines). Since most lines are not 72 characters long, 
more than 28 lines can usually be displayed with HALF ON. This feature 
is particularly useful during assembly or compiling operations when 
additional symbol table space is required. 

Form: HALF ,_*{ }) 

8. 8. 2.3 CTRL X - This command, formed by typing CTRL and X simul- 
taneously, alternately switches text output either to the teleprinter 
or to the VT04 screen. Once VT ON has been issued, CTRL X can be 
typed at any time (i.e., with the Monitor, a system program, or a 
user program) to change output control. An up-arrow (1 ) is echoed on 
the device to which control is transferred. 

8. 8. 2. 4 Command Default Settings - The commands VT ON/OFF and 

HALF ON/OFF can be initially set during system generation to meet 
user requirements. The default settings for the XVM/DOS system as 
initially supplied are: VT OFF and HALF OFF. 

8.9 MISCELLANEOUS COMMANDS 

8.9.1 API ON/OFF 

This command controls the status of the Automatic Priority Interrupt 
System for machine configurations having this option. The ON 
argument enables the API and the OFF argument disables the API. 

Form: API 
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If the API hardware is not available, the following message is output: 
API NOT AVAILABLE 


and the system parameter is set to reflect its absence. Whenever the 
API ON/OFF command is given, a mode specification message is output as 
described in Section 8.3.4. 


8.9.2 TAB ON/OFF and FILL ON/OFF 


The TAB command specifies whether or not the system should simulate 
the tab character. Specifying "TAB ON", conditions the XVM/DOS Moni- 
tor to simulate tabs with the appropriate number of spaces. 

Form: 

The FILL command enables (ON) and disables (OFF) fill character inser- 
tion. Fill characters are necessary to allow completion of carriage 
returns on LA30S running at 300 band. 


Form: 


FILL »-i 



The TAB and FILL specification settings are independent of each other. 


The following chart summarizes the TAB and FILL settings necessary 
for several devices: 


FILL 



ON 

OFF 

ON 

LA30 (300 baud) 

LA30 (110 baud) 
LA36 

TAB 


KSR33 

OFF 


KSR35 
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8.9.3 CHANNEL 7/9 

This command sets a constant in the Monitor which is used by the Mag- 
tape device handlers as the default operation parameter for 7- or 9- 
channel operation. Refer to the description of the Magtape handlers 
in Chapter 9 for further information. 

Form : C [ HANNEL] 

8.9.4 LP ON/OFF 

This command permits the text output resulting from the System Informa- 
tion Commands REQUEST, REQUEST USER, and SCOM to be output to a line 
printer, if one is available. The ON argument directs output to the 
line printer and the OFF argument restores output to the teleprinter. 

NOTE 

For INSTRUCT and INSTRUCT ERROR: Assign 

LP to .DAT -12 to output to the line printer 

Form: LP^j™^^ 

8.9.5 BANK ON/OFF - PAGE ON/OFF 



These commands permit the user to select either Bank or Page Mode oper- 
ation. In Page Mode, relocatable user programs and device handlers are 
loaded within 4K memory pages, and Index Register usage is permitted. 
Library routines are loaded from the library residing in the PAG UFD. 

In Bank Mode, Index Register usage is not permitted, and user programs 
(including device handlers) are loaded within 8K memory banks, and 
system library routines are loaded from the library contained in the 
BNK UFD. Either BANK OFF or PAGE ON sets the system to operate in 
Page Mode. Conversely, BANK ON or PAGE OFF sets the system to operate 
in Bank Mode. 


Form: 


BANK 



or 



Whenever the BANK ON/OFF or PAGE ON/OFF commands are given, a mode 
specification message is output as described in Section 8.3.4. 
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8.9.6 POLLER ON/OFF 1 


This command controls the UNIBUS device error 'poller' initiated by 
the XVM on a UNICHANNEL-15 system. The ON argument enables the oper- 
ation of the poller while the OFF argument disables the operation of 
the poller. This command is provided to temporarily permit usage as 
a single integrated system or as two distinct and separate systems. 


Form: 


POLLER 


ON 

OFF 




The poller checks both the "UC15" and POLLER switches to determine if 
it should run. The "POLLER ON/OFF" command has no effect with "UC15 
OFF", however, if the "UC15 ON" command is subsequently given, the 
setting of the "POLLER" switch determines whether or not the poller 
should run. 


The poller periodically queries the UC15 PIREX monitor for the pres- 
ence of error conditions. UC15 option system users wanting to either 
place the UNICHANNEL system off line for maintenance or to use the 
UC15 processor to run other PDP-11 monitors (such as RSX-11M or RTll) 
will want to turn the POLLER OFF. Whenever the POLLER ON/OFF command 
is given, a mode specification message is output as described in 
Section 8.3.4. 

8.9.7 DATE 


This command is used either to enter a calendar date or to examine 
the calendar date currently stored in the Monitor. This information 
is used by the system to indicate the date of creation of mass storage 
files. If no date has been entered into the system, each time con- 
trol is returned to the Monitor it outputs a message requesting that 
a date be entered. When a date is to be entered, the entire date 
(month, day and the last two digits of the year) must be typed. The 
DATE command with no argument causes the date currently stored in the 
Monitor to be typed out. When 2400 hours have passed, the system 
automatically requests a fresh date to be entered. The clock is re- 
quired with the UC15 system. 

Form : D [ate] [mm [/]cd[/]yy], 


1 „ _ . , 

ror uu-LD sy seems onxy. 
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where: 

mm = Month (01-12) 

dd = Day of Month (01-31) 

yy = Year (70-99) 

If the slash delimiters (/) are used, leading zeroes can be omitted; 
otherwise all six digits must be typed. 

8.9.8 TIME 


This command is used either to enter or to examine the time of day 
currently stored in the Monitor. This information is updated by the 
Monitor every second. When time is to be entered, it must be typed 
as a 4-digit number (0000-2359) in 24-hour clock notation. The TIME 
command with no argument causes the current time of day (as kept in 
the Monitor) to be typed out. 

Form : T [iME] |J_jhhmm] ) 

where: 

hh = Hours (00-23) 
mm = Minutes (00-59) 

8.9.9 TIMEST 


This command instructs the Monitor to terminate the current operation 
and restart itself after a specified time interval has elapsed. The 
command is particularly applicable when operating in Command Batching 
Mode (discussed in 8.12), since it permits users to unconditionally 
terminate a program's operation if its execution time exceeds that 
value expected for normal operation. The time interval can be speci- 
fied in minutes, seconds, or a combination of both. The maximum time 
interval (total minutes and seconds) can not exceed 131,071 seconds. 
Once executed, a TIMEST command can only be nullified by a subsequent 
LOGIN or LOGOUT command. 


Form: 


TIMEST t_j 



Example: TIMEST 5281 (5281 seconds) 


or 


where : 


mm - Minutes 
ss = Seconds 


TIMEST 88:1 (88 minutes, 1 second) 
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8.9.10 LOG 

This command instructs the Monitor to ignore subsequent keyboard input 
and is used primarily for making operator comments. Typing ALT MODE 
restores the keyboard for normal command input. 

Form: L |[og] y 1 

comment 

comment ALT MODE 

8.9.11 HALT 

■phis command will cause the Monitor to halt computer operation after 
terminal IOPS errors. Press CONTINUE, followed by CTRL P or CTRL C to 
continue system operation. 

Form: h[alt]^) 

8.9.12 CTRL D 

This command, formed by simultaneously striking the CTRL and D keys on 
the teleprinter keyboard, is used to indicate an end-of-file condition 
when the keyboard is used as an ordinary input device (as opposed to its 
being used as a command input device). CTRL D signals the teleprinter's 
device handler, or other keyboard device handler, if available, to 
transmit a header word pair to the requesting program's I/O buffer in 
which bits 14-17 are set to the end-of-file code 0101 2 * An Y informa- 
tion currently in the buffer is lost. In IOPS ASCII mode, therefore, 
a Carriage RETURN should always precede a CTRL D in order to assure 
output of the last line. 

8.9.13 UCl 5 ON/OFF 

This command is used to enable and disable the use of the UC15 peri- 
pheral processor. 

/ 

If the UCl 5 hardware is not present, it is not enabled and the follow- 
ing message is output: 

UNICHANNEL NOT AVAILABLE 


Form: UC15, 


Jon 

I OF 
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When the UC15 is disabled, the POLLER ON/OFF command has no effect 
(see paragraph 8.9.6). 

Whenever the UC15 ON/OFF command is given, a mode specification message 
is output as described in Section 8.3.4. 

8.10 SYSTEM PROGRAM LOADING COMMANDS 

The commands described in Table 8-1, System Program Loading Commands, 
are used to instruct the system loader within the Monitor to load the 
various language and utility programs which are part of the XVM/DOS 
Software System. Each command must be typed as shown, terminated by 
either a Carriage RETURN or ALT MODE. 

8.11 PROGRAM START/RESTART/CONTINUE COMMANDS 

The commands described below are used to provide keyboard control 
during system and user program operation. The format of these com- 
mands has been previously described in paragraph 8.2.1. 

8.11.1 CTRL C 

This command returns control to the Nonresident Monitor. It can be 
typed at any time, signaling the Monitor that the user wishes to abort 
a program, or enter a keyboard command. In returning control to the 
Nonresident Monitor from a previously executing program, all device 
and UFD assignments are returned to their default settings unless the 
KEEP ON command is in effect, in which case, device and UFD assignments 
are not affected (see 8.5.2 and 8.5.3). CTRL C can also be used to 
terminate the Monitor's processing of all keyboard commands except for 
TIMEST (see 8.9.8) . 

8.11.2 CTRL P 

This command restarts system programs, terminating current operation. 
Upon execution of this command, control is transferred to the start 
address specified in the last . INIT I/O Macro to the teleprinter. 

User programs may use this restart facility by issuing a .INIT macro 
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to .DAT -2 (which is normally permanently assigned to the teleprinter 

handler). See 6.7.6 and the description of the teleprinter handler 
in Chapter 9. CTRL P is ignored until the teleprinter handler recei- 
ves the proper .INIT. 

8.11.3 CTRL S 

This command is used to start a program loaded by the Linking Loader 
via the LOAD command. 

8.11.4 CTRL T 

This command is used only with the DDT program and the Monitor's 
Command Batching Mode (see BATCH described below) . When used with 
DDT, CTRL T terminates execution of the program being debugged and 
causes DDT to enter command mode. When used with the Monitor's 
Command Batching Mode, it causes the current job to be terminated 
and skips to the next job. 

8.11.5 CTRL R 

This command permits the user to continue program operation either 
after an I0PS4 (I/O device not ready) error occurs, or after the 
execution of a $PAUSE (see 8.12.3.4). Prior to typing this command, 
the user must first correct the condition which caused the error 
(e.g. , DECtape unit incorrect, OFF LINE, etc.). 

8.12 BATCHING KEYBOARD COMMANDS 

Most of the Monitor's keyboard commands, as well as the keyboard com- 
mands for most system programs, can be issued from the card reader, 
a mass-storage file or the paper tape reader. This is possible when 
the system is in the Monitor's Command Batching Mode. Batching 
Mode allows many programs to be run in sequence with minimum opera- 
tor intervention. A typical sequence of operations might include 
file editing, assembly and program execution. All commands input 
from the batch device are echoed on the console teleprinter. 

8.12.1 Preparation 


For Command Batching Mode, the programmer must prepare a file, a 

V- -a ~ ^ y, v VU 4 _U ~ ^ ~ 4- 4 -L. ~ 1 T ~~ ^3 

uu^/c w C4. UCOA, W 4. pUUl^UCU LQIUO W 11 _L Oil UUULaXllO UiiC U\JCL±. kA 
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commands for the operations performed. These commands should be in 
the same order and form as they would normally be issued from the 
teleprinter keyboard. The only exception to this is that certain job 
control commands may be inserted in the command sequence. When pre- 
paring batch files, the user will find it convenient to use the system's 
Text Editor Program EDIT. When preparing commands for input from cards, 
the user can prepare his cards using a card punch which punches either 
029 or 026 Hollerith codes (see Appendix F) . 

8.12.2 Operator Commands 

The following commands are provided for operator control: 

8.12.2.1 BATCH - This command is used to enter Command Batching Mode. 
Once this command is issued, the Monitor begins to read from the batch 
device specified (PR = paper tape reader, CD = CR03B or CR15 card reader) . 

Form: B [ATCH] i_idv{unit},_|{ <uic> } ui{ f ilnam} 

where dv is any device name (see Section 8.5.2) uic, (see 
Section 8.5.2), and f ilnam is the name of the batch command 
file, with the fixed extension of 'BAT'. 

8.12.2.2 CTRL T - This command causes the Monitor to skip to the next 
job (i.e., skip to the next $JOB job separator. See 8.12.3.1). 

8.12.2.3 CTRL C - This command is used to terminate Command Batching 
Mode operation. It operates in all other respects as it does with 
normal keyboard operation (see 8.11.1). 

8.12.2.4 CTRL R - This command is used to recover from either the 
execution of a $PAUSE (see 8.12.3.4) or an IOPS4 (see 8.11.5). 

8.12.3 Job Control Commands 

The following commands are inserted into the normal keyboard command 
sequences on the batch device medium to provide job control. 

8.12.3.1 $JOB - This command separates one job from the next. The 
command operates, within the context of Command Batching Mode, in a 
manner si milar to the CTRL C comma nd since it causes the Batching 
Mode Nonresident Monitor to be reloaded, and all . DAT/ . UFDT slot 
assignments to be reset to their default setting, if KEEP is OFF. 
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$ JOB may occur as the first command on the batch medium and can be 
used thereafter each time the user wishes to exit from the current 
program and issue another command to the Monitor. 

Form: $JOB [,__jcomment]^ 

where: comment = User comments 

8.12.3.2 $DATA - When the batch device is to be used for data input 
(as it might be in non-batch mode) , this command marks the beginning 
of the data. Unlike BATCH commands, data is not printed on the tele- 
printer. 

Form: $DATA[. .comment ]j 

where: comment = User comments 

8.12.3.3 $END - This command follows the $DATA command and data to 

'2 

signify the end of the date, and c auses an end of file indication 
to be sent to the program. 

Form: SEND f T .comment!^ 

where: comment = User comments 


8.12.3.4 $PAUSE - This command terminates input from the batch device 
until the operator types a CTRL R. It has particular application when 
the user wishes to signal the operator to mount a DECtape, reload the 
batch device, or perform some other manual operation. 


Form: $PAUSE [. .comment] 




where: comment = User comments 

8.12.3.5 $EXIT - This command signals the Monitor to leave Command 
Batching Mode and resume operation using commands from the console 
keyboard . 

Form: $EXIT [, .comment] . 


where: comment = User comments 


8.12.4 Restrictions 


When operating in Command Batching Mode, the following restrictions 
apply: 
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a. The following commands are illegal: QDUMP, HALT, GET (all 

forms), PUT, BATCH, BOSS, LOAD, DDT, API ON/OFF. 

b. Any ASSIGN command which refere nce s the pseudo-device name 
'CM' automatically obtain tjie^service s of the current ba tch, 
device handler. 

8.13 KEYBOARD ERROR DETECTION AND HANDLING 

The Monitor performs comprehensive error checking on all keyboard com- 
mands typed. Upon detection of an error, an appropriate message is 
output to the teleprinter indicating the nature of the error, and the 
remainder of the line from the error is ignored. The dollar sign ($) 
prompting symbol is then output to indicate the Monitor's readiness 
to accept another command. Keyboard errors which result during opera- 
tion of system programs are explained in the appropriate reference 
manual for the particular program (see Preface) . Error messages which 
are prefixed by "IOPS", "IOPSUC", " . SYSLD" or ".LOAD" are listed and 
explained in Appendices D, J and E, respectively. 
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CHAPTER 9 

I/O DEVICE HANDLERS 


9 . 1 INTRODUCTION 

This chapter describes the I/O device handling routines which are sup- 
plied as a part of the XVM/DOS system software. Included in this chap- 
ter are their operating characteristics and their applicability for use 
with the various language and utility programs in the XVM/DOS system. 

Each I/O device handler has a unique three-character name which is used 
when assigning it to a .DAT slot via the ASSIGN keyboard command (see 
8.5.2). The first two characters of the name designate the device with 
which the handler operates. For example: DK = DECdisk? DP = Disk Pack? 

RK = Disk Cartridge? TT = Teleprinter, etc. The third character speci- 
fies a particular version of a handler, since some I/O devices have 
several handlers. Thus, DKA designates the "A" version of the DECdisk 
device handler. Similarly, DTC is the "C" version of the DECtape 
handler. Table 9-1 lists the standard XVM/DOS I/O device handlers. 

The availability of several handler versions allows the user who is 
concerned with core utilization to select a particular version with the 
size and capabilities most nearly suited to his needs. Device handler 
versions differ from one another in the number of I/O functions (Macros) 
and Data Modes allowed, and in the number of files which can be accessed 
concurrently. The fewer capabilities allowed, the smaller the handler. 
"A" version handlers are the largest, but also provide the greatest 
capabilities. Other versions are more limited, and consequently are 
smaller. 

In selecting a handler, the user most consider all I/O requirements 
for the program with which it is to run. What I/O Macros and Data Modes 
are used? Is output required? How many files may be concurrently open? 
To assist the user in selecting handlers, paragraph 9.2 lists all 
versions of the handlers which can be assigned to the various .DAT 
slots used by the various XVM/DOS System programs, and paragraph 9.3 
describes the specific functional characteristics of the handlers. 
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Table 9-1 

XVM/DOS I/O DEVICE HANDLERS 1 


Device Name 



Version 


A 

B 

C 

D 



DK 

(DECdisk) 

/ 


/ 


|| 

i 

DP 

(Disk Pack) 

/ 

/ 

/ 




RK 

(Disk Cartridge) 

/ 

/ 

/ 




DT 

(DEC tape) 

/ 


/ 

~ 7 

/ 

/ 

TT 

(Teleprinter) 

/ 






PR 

(Paper Tape Reader) 

/ 

/ 





PP 

(Paper Tape Punch) 

/ 

/ 

/ 




LP 

(Line Printer) 

/ 






CD 

(Card Reader) 


/ 





VP 

(VP15A Display) 

/ 






MT 

(Magtape) 

/ 


/ 



/ 

XY 

(XY11/XY311 Plotter) 

/ 







9.2 DEVICE HANDLERS ACCEPTABLE TO SYSTEM PROGRAMS 2 

The following paragraphs provide listings of .DAT Slot assignments 
for the various system programs and the I/O device handlers which 
may be assigned to each. 


By convention, all system programs use .DAT -2 for command input and' 
.DAT -3 for output. Both .DAT slots are permanently assigned to the, 
console device or the batch device file, if in Batch mode. PIP uses! 
these .DAT slots whenever teletype I/O is requested, thus freeing 
positive slots for other devices. Further all system programs use 
.DAT -11 and/or -14 for input, -13 and/or -15 for output, -12 for ) 
listings and -10 for secondary input. ' 

2 

Users having a VT15 Graphic Display System should refer to the VT15 
XVM GRAPHICS Software Manual for descriptions of the associated de- 
vice handlers, VTA, LKA, and VWA .. 
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NOTE 


Only one version of an I/O handler for a partic- 
ular device may be in core at the same time, since 
there is no communication between the interrupt 
handling routines. 


9.2.1 FORTRAN IV (F4) 














9.2.2 MACRO 


.DAT Slot 

Use 

Handler 

-14 

Macro 

Definitions 

File 

TTA 

PRA 

PRB 

CDB 

DKA, DP A, DTA, MTA RKA 

DKB, DPB, DTD RKB 

DKC , DPC , DTE RKC 



-13 

Output 

PPA 

PPB 

DKA, DPA RKA 

DKB , DPB RKB 

-12 

Listing 

Output 

*TTA 

LPA 

VPA 

PPA, DPA, DTA, MTA RKA 

DKA, DPB, DTD RKB 

DKB , DTE 

-11 

Input 

TTA 

PRA 

PRB 

CDB 

DKA, DPA, DTA, MTA RKA 

DKB, DPB, DTD RKB 

DKC, DPC, DTE RKC 

0 

t — i i — i 

1 i 

Parameter 

File 

Input 

System MACRO 
File Input 

TTA 

PRA 

PRB 

CDB 

DKA, DPA, DTA, MTA RKA 

DKB, DPB, DTD RKB 

DKC, DPC, DTE RKC 

Same as -11 (input) 

9.2.3 MACH 

.DAT Slot 

Use 

Handler 

-12 

Listing 

Output 

TTA 

LPA 

VPA 

PPA, DP A, DTA, MTA RKA 

DKA, DPB, DTD RKB 

DKB , DTE 

-11 

Input 

TTA 

PRA 

PRB 

CDB 

DKA, DP A, DTA, MTA RKA 

DKB, DPB, DTD RKB 

nDP TWG 1 
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9.2.4 FOCAL 


.DAT Slot 

Use 

Handler 

3 

Library 

Input 

TTA 

PRA 

PRB 

CDB 

DKA, DP A, DTA, MTA RKA 

DKB , DPB , DTC , MTC RKB 

DKC , DPC , DTD RKC 

DTE 

5 1 

Library 

Output 

TTA 

PPA 

DKA, DP A, DTA, MTA RKA 

DKB, DPB, DTD RKB 

LPA, DTE 

VPA 

7 

. 

Data File 
Input 

TTA 

PRA 

PRB 

CDB 

DKA, DPA, DTA, MTA RKA 

DKB, DPB, DTC, MTC RKB 

DKC, DPC, DTD RKC 

DKE , DTE 

10 

Data File 
Output 

TTA 

PPA 

DKA, DPA, DTA, MTA RKA 

DKB, DPB, DTD RKB 

LPA DTE 

VPA 


^rior to loading FOCAL, this .DAT slot must be assigned to one 
of the devices listed, if library output is desired. 
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9.2.5 EDIT, EDITVP, and EDITVT 










.DAT Slot 

Use 



Handler 











-15 

Scratch/ 

TTA 







Output 

VPA 

LPA 

PPA 

DKA, 

DPA, 

DTA, 

MTA 

RKA 




DKB, 

DPB, 

DTD 


RKB 






DTE 




-14 

Input 

TTA 

PRA 

PRB 

CDB 

DKA, 

DPA, 

DTA, 

MTA 

RKA 




DKB, 

DPB, 

DTD 


RKB 




DKC, 

DPC, 

DTE 


RKC 


-13 

Secondary 

Same as .DAT 

-15. 





Output 







-12 

Listing 

LPA 

TTA 

PPA 

VPA 




Output 



PPB 








PPC 




-10 

Secondary 

TTA 







Input 

PRA 

PRB 

CDB 

DKA, 

DPA, 

DTA, 

MTA 

RKA 




DKB, 

DPB, 

DTD 


RKB 




DKC, 

DPC, 

DTE 


RKC 


10 

Display 

Output 

(EDITVP only) 

VPA 







9.2.6 Linking Loader and DDT 


HjMMI 

Use 

Handler 

EiMRHHMi 


-5 

External 

NON 





User 

(same 

as .DAT 

slot -4 

when used for 


Library 

user 

library) 




Input 





-4 

User 

PRA 





Program 

DKA, 

DPA, 

DTA, 

RKA 


Input 

DKB, 

DPB, 


RKB 



DKC, 

DPC, 

DTC 

RKC 





DTD 






DTE 


-1 

System 

PRA 





Library 

DKA, 

DPA, 

DTA 

RKA 


Input 

DKB, 

DPB, 


RKB 



TM/P 

f 

nnn 

Ljrr^f 

DTC 

RKC 





DTD 






DTE 
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9.2.7 PIP (Peripheral Interchange Program) 

PIP uses all positive .DAT slots and -2 and -3 for TTY I/O. Prior to 
use, any non-standard device assignments should be made via the ASSIGN 
command to the Monitor. If several functions are to be used with a 
variety of peripherals, assignment of these devices all at the same 
time avoids the necessity for returning to the Monitor to reassign 
devices and for repeatedly reloading PIP after each operation that 
requires a new device. 

NOTE 

The device handlers used with PIP should normally 
be those having the greatest capability (i.e., PRA, 

PPA, DTA, DKA, etc.). If both input and output are 
to occur on the same device (e.g., DECtape) , separate 
.DAT Slots must be assigned. Both .DAT Slots must 
be assigned to the same handler. 


Positive .DAT Slot assignments for the system, as initially supplied, 
are as follows : 


.DAT Slot 

Use 

Handler 

1 

I/O 

*DKA or *DPA or *RKA 

2 

I/O 

*DKA or *DPA or *RKA 

3 

I/O 

*DKA or *DPA or *RKA 

4 

I/O 

*TTA 

5 

Input 

*PRA 

6 

Output 

*PPA 

7 

I/O 

*DTA 

10 

I/O 

*DTA 

11 

I/O 

*NON 

12 

I/O 

*NON 

13 

I/O 

*NON 

14 

I/O 

*NON 

15 

I/O 

*NON 

16 

I/O 

*NON 

17 

I/O 

*NON 

20 

I/O 

*NON 


9.2.8 SGEN (.System Generator) 


.DAT Slot 

Use 

Handler 

-14 

Input/Output 

DKA or DPA or RKA 
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9.2.9 PATCH 


.DAT Slot 

Use 

Handler 

-14 

I/O 

DKA, DPA, DTA, RKA 

DTD 
DTE 

-10 

Secondary 

Input 

TTA 

PRA 

DKA, DPA, DTA, RKA 


9.2.10 UPDATE 



9.2.11 DUMP 


.DAT Slot 

Use 

Handler 


1 


-14 

Input 

DKA, DPA, DTA, MTA, RKA 

DKB , DPB , DTD RKB 

DKC , DPC , DTE RKC 

-12 

Listing 

TTA 

LPA 

VPA 

PPA 

DKA, DPA, DTA, MTA, RKA 

DKB, DPB, DTD RKB 

DTE 
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9.2.12 CHAIN 


.DAT Slot 



Use 

Handler 

User 

Library 

*NON (Same as .DAT slot -4 when used) 

Input 

PRA 

DKA, DP A, DTA, RKA, MTA f Use only 

DKB, DPB RKB if no other 

DKC, DPC, DTC, RKC , MTC < DT, DK, or 

DTD I MT is as- 

DTE V. signed. 

System 

Library 

Same as for .DAT -4 



NOTE 

Use the smallest 
as user handlers 

handlers possible since they are not recoverable 
in the overlay system. 




.DAT Slot 

Use 

Handler 

-4 

Load CHAIN- 

Built 

Program 

RKA, DKA, DPA, DTA, MTA 

DTD, 

DTE 



9.2.14 SRCCOM 


.DAT Slot 



New File 
Input 


Original File 
Input 


Handler 


(if not assigned to -14) 
(if not assigned to -14) 
(if not assigned to -14) 


*DKA, 

DKB, 

DKC, 

*DPA, 

DPB, 

DPC, 

DTA, 

DTD, 

DTE 

MTA, 

*RKA 

RKB 

RKC 

TTA 

(if 

not assigned 

to -15) 


PRA 

(if 

not assigned 

to -15) 


CDB 

(if 

not assigned 

to -15) 


DKA, 


DPA, 

DTA, 

MTA, 

RKA 

DKB, 


DPB, 

DTD 


RKB 




DTE 
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SRCCOM (Cont.) 



Use 

Handler 

' 


-12 

Listing 

TTA 

PPA 

LPA 

VPA 

DKA, DPA, DTA, MTA, RKA 

DKB, DPB, DTD, RKB 

DTE 


9.2.15 8 TRAN 



Use 

Handler 

■ 

Input 

PRA 




H I 


CDB 






TTA 






DKA, 

DPA, 

DTA, MTA 

RKA 



DKB, 

DPB, 

DTD 

RKB 

II 


DKC, 

DPC, 

DTE 

RKC 


Output 

PPA 






LPA 






TTA 






VPA 




1 


DKA, 

DPA, 

DTA, MTA, 

RKA 



DKB, 

DPB, 

DTD 

RKB 





DTE 



9.2.16 MTDUMP 



Use 

Handler 

i 

Input 

MTA 

MTF 


3 

Output 

VPA, 

LPA, 

TTA 


Prior to loading this program, the .DAT slots must be reassigned to 
one of the handlers listed here. 
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9.2.17 SPOOL 1 



-14 Temporary RKA, DPA, DKA 

File 
Storage 


9.2.19 SPLOAD 


-14 

Install 

SPOLll 

Image 

RKA, 

DPA, 

DKA 

none 

SPOLll 

Input 

Paper 

tape 

(no handler) 


9.2.20 MCLOAD 1,2 



1 UNICHANNEL systems only. 

2 

Prior to loading this program, the paper tape output of MAC 11 
containing the spooler should be readied in the paper tape reader. 
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9.3 I/O HANDLER DESCRIPTIONS 

The following paragraphs describe the operating features of the stan- 
dard XVM/DOS I/O Device Handlers. The XVM/DOS System Manual describes 
functions which are internal to the handlers and provide instructions 
to assist users in creating their own special device handlers. Users 
having a VT15 Graphics Display System should refer to the VT15 XVM 
GRAPHICS Software Manual for descriptions of the associated device 
handlers VTA, LKA, and VWA. 

9.3.1 Teleprinter Handler (TTA) 

9. 3. 1.1 General Description - The teleprinter handler is embedded in 
the Resident Monitor and provides all functions necessary for tele- 
printer input/output. The handler performs I/O using either IOPS ASCII 
(Mode 2) or Image 'Alphanumeric (Mode 3) data. Table 9-2 lists the 
handler's responses to the various I/O Macros. 


Table 9-2 


TELEPRINTER I/O FUNCTIONS 


Macro 

Response 

. IN IT 

Accept 

. FSTAT 

Ignore 

.RENAM 

Ignore 

. DLETE 

Ignore ' 

.RAND 

Illegalv, 

. RTRAN 

Illegal, 

• SEEK 

Ignore 

.ENTER 

Ignore 

.CLEAR 

Ignore 

•CLOSE 

Accept 

.MTAPE 

Ignore 

.READ 

Accept 

.WRITE 

Accept 

.WAIT 

Accept 

. WAITR 

Accept 

.TRAN 

Illegal 


Illegal - Illegal Function (I0PS6) 
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9. 3. 1.2 Device Dependent Characteristics - The following paragraphs 
describe the characteristics which are unique to the teleprinter 
handler in its response to certain I/O Macros and characters: 


a. . INIT 1) Maximum I/O buffer size returned: 42g(34^) 

2 \ Set up CTRL P restart address from address 
specified in .INIT argument "restrt". Refer 
to the XVM/DOS System Manual for setup of the 
restart address for CTRL C and CTRL T. 

3) Output Carriage RETURN/LINE FEED 

4) A .INIT issued to the teletype handler 
will not cancel a .READ/. WRITE which 
is in progress. 

.SCOM+35 contains the instruction 
"DZM/TTIOSW" . If a program desires to 
abort teletype I/O, it can execute the 
instruction "XCT* (.SCOM+35)", which 
will clear out the busy flag. 


b. .CLOSE - Output Carriage RETURN/LINE FEED. 

c. .WRITE - When in IOPS ASCII Mode a LINE FEED is normally 

output automatically before the line (logical 
record) is output unless an Overprint (20) is 
the first character (see Table 9-3) . 

d. Nonprinting Function Characters - The non-printing 

function characters contained in Table 9-3 
have special significance when input and out- 
put in IOPS ASCII mode. 


Table 9-3 

SPECIAL NON-PRINTING FUNCTION CHARACTERS FOR IOPS ASCII TELEPRINTER I/O 


FUNCTION 

TRANSFER 


(ASCII in parentheses) 

DIRECTION 

ACTION 

Carriage RETURN 

Input 

Insert all characters typed, includ- 

(015) 


ing this Carriage RETURN, since the 
last Carriage RETURN or ALT MODE, 
into the requesting program's I/O 
Buffer. Echo a LINE FEED on the 
printer. 


Output 

Terminate output of the contents 
of the requesting program's I/O 
buffer. Output Carriage RETURN. j 
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Table 9-3 (Cont.) 


SPECIAL NON-PRINTING FUNCTION CHARACTERS FOR IOPS ASCII TELEPRINTER I/O 


FUNCTION 

(ASCII in parentheses) 

1 

TRANSFER 

DIRECTION 

ACTION 

ALT MODE 
(33, 175, 176) 

Input 

Terminate the current line and in- 
sert all characters typed since the 
last Carriage RETURN or ALT MODE into 
the requesting program's I/O buffer. 
Map into the I/O Buffer as 175. 


Output 

Terminate output of the contents of 
the requesting program's I/O buffer. 

LINE FEED 
(012) 

Input 

Insert in requesting program's I/O 
buffer. 


Output 

Ignore if this is the first charac- 
ter in the I/O buffer; otherwise, 
output. 

VT (Vertical Tab) 
(013) 

Input 

Insert in requesting program's I/O 
buffer . 

or 



FORM Feed 
(014) 

Output 

Model 35 teleprinters output FORM 
Feed . 

LA36, Model 33 and LA30 teleprinters 
ignore . 

Horizontal TAB 
(011) 

Input 

Insert in requesting program's I/O 
buffer . 


Output 

If Monitor Command TAB OFF is in 
effect (no TAB simulation) . 

If TAB ON is in effect, output 
sufficient number of SPACES (040) 
to position printer at columns 9, 
17 , 25 , . . . etc . 

Skip One Line 
(021) 

Output 

Only 

If this is the first character in the 
requesting program's I/O buffer, skip 
1 line. Otherwise, ignore. 

Overpr int 
(020) 

Output 

Only 

If this is the first character in the 
requesting program's I/O buffer, 
suppress the LINE FEED normally out- 
put. Otherwise, ignore. 

RUBOUT 

(177) 

Input 

Delete the last character typed 
previous to this and echo a backslash 
( \ >. 

CTRL U 

(025) 

Input 

Delete all characters typed since 
the last Carriage RETURN or ALT 
MODE, and echo an "at" sign ( @ ). 


Output 

ljL~d^¥P-.sd_,whj^ way , 

truncate the remainder of. the .Tgar^»4». 

record being output/” ' 
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Table 9-3 (Cont.) 

SPECIAL NON-PRINTING FUNCTION CHARACTERS FOR IOPS ASCII TELEPRINTER I/O 


FUNCTION 

(ASCII in parentheses) 

TRANSFER 

DIRECTION 

ACTION 

Null 

( 000 ) 

Input/ 

Output 

Ignore 



Transmit to the requesting program's 
I/O buffer a logical record which 
consists of a header word pair only , 
With the I/O Mode Bits (14-17) set 
to 0101 to indicate end -of -file. 

(See paragraph^ . 3 .1.1. ) 


9. 3- 1.3 Program Control Characters - The teleprinter retains its role 
as control device during all I/O operations. The CTRL characters 
(CTRL C, CTRL P, CTRL S, and CTRL T) are recognized when typed, regard- 
less of Data Mode or transfer direction. These characters perform 
specific system functions as described in 8.1 . Experienced users who 
wish to alter their meaning may do so using procedures described in 
the XVM/DOS System Manual . 

9.3.2 Paper Tape Punch Handlers (PPA, PPB, and PPC) 

9. 3. 2.1 General Description - There are three paper tape punch 
handlers: PPA (571g registers) , PPB (416g registers) , and PPC (3 2 2 Q 

registers) . Sizes listed are approximate. All three handlers respond 
identically to the I/O Macros, but differ as to the various data modes 
which are acceptable to them. Table 9-4 lists the data modes which 
are acceptable and Table 9-5 shows the handlers' responses to the I/O 
Macros . 


Table 9-4 


PAPER TAPE PUNCH DATA MODES 


Data Mode 

H 

andler 

PPA 

PPB 

PPC 

IOPS ASCII 

X 

- 

- 

IOPS Binary 

X 

X 

X 

Image 

Alphanumeric 

X 

X 

- 

Image Binary 

X 

X 

- 

Dump 

X 



X 

- 
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Table 9-5 


PAPER TAPE PUNCH I/O FUNCTIONS 


Macro 

Response 

. INIT 

Accept 

. FSTAT 

Ignore 

.RENAM 

Ignore 

. DLETE 

Ignore 

.RAND 

Illegal 

. RTRAN 

Illegal 

.SEEK 

Illegal 

.ENTER 

Ignore 

. CLEAR 

Ignore 

.CLOSE 

Accept 

. MTAPE 

Ignore 

.READ 

Illegal 

.WRITE 

Accept 

.WAIT 

Accept 

. WAITR 

Accept 

.TRAN 

Illegal 


Illegal = Illegal Function (IOPS6 Error) 


9. 3. 2. 2 Device Dependent Characteristics - The following paragraphs 
describe the characteristics which are unique to the Paper Tape Punch 
Handlers in their response to certain I/O Macros and characters. 


a. . INIT - 1) Maximum I/O buffer size returned: 64 (52) . 

8 10 

2) Punches two fanfolds of leader. 

b. .CLOSE- 1) Output EOF (end-of-f ile) header word pair 

(see 6. 3. 1.1) as last record on the tape 
(for IOPS Binary mode 0 , only) . 

c. Special Characters - The characters listed in Table 9-6 have 

special significance to the handlers when output 
in IOPS ASCII Mode. These characters, except TAB, 
are ignored if they do not appear as the first 
character in a logical record (line) . If a LINE 
FEED, VT (Vertical TAB) , or FORM Feed does not 
appear as the first character in a logical re- 
cord, a LIME FEED is supplied by the handlers. 
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Table 9-6 

SPECIAL FUNCTION CHARACTERS FOR FIRST CHARACTER IN LINE 


FUNCTION 

ACTION 1 

LINE FEED 

Output . 

(012) 


VT (Vertical TAB) 

Output, followed by four RUBOUTs 1 (177). 

(013) 


FORM FEED 

Output, followed by 40 Nulls 1 (000) . 

(014) 


Horizontal TAB 

Output, followed by one RUBOUT 1 (177) . 

(011) 



9.3.3 Paper Tape Reader Handlers (PRA and PRB) 

There are two paper tape handlers: PRA (673^ registers) and PRB (446g 

registers) . Sizes shown are approximate. Both handlers respond iden- 
tically to the I/O Macros, but differ as to the data modes which are 
acceptable. Table 9-7 lists the data modes which are acceptable, and 
Table 9-8 shows the handlers' response to the I/O Macros. 


NOTE 

PRA and PRB ignore any nulls or rubouts en- 
countered in IOPS ASCII mode. PRA ignores 
any nulls encountered in IOPS BINARY mode. 


Table 9-7 


PAPER TAPE READER DATA MODES 


Data Mode 

Handler 

PRA 

PRB 

IOPS ASCII 

X 

X 

IOPS Binary 

X 

- 

Image 

Alphanumeric 

X 

- 

Image Binary 

X 


Dump 

X 



The RUBOUT and NULL functions which follow output of the desired 
characters are used for hardware timing purposes when the paper tape 
is to be transmitted to a printer in an off-line environment. 
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Table 9-8 


PAPER TAPE READER I/O FUNCTION 


Macro 

Response 

. INIT 

Accept 1 

.FSTAT 

Ignore 

.RENAM 

Ignore 

, DLETE 

Ignore 

.RAND 

Illegal 

. RTRAN 

Illegal 

.SEEK 

Ignore 

. ENTER 

Illegal 

.CLEAR 

Illegal 

.CLOSE 

Accept 

.MTAPE 

Ignore 

.READ 

Accept 

.WRITE 

Illegal 

.WAIT 

Accept 

. WAITR 

Accept 

.TRAN 

Illegal 


Illegal = Illegal Function (IOPS6 Error) 

9.3.4 DECtape Handlers (DTA, DTC, DTD, DTE, and DTF) 

9. 3. 4.1 General Description - There are five DECtape handlers for 

TU55/TU56 DECtape operation. Sizes shown are approximate. 

• DTA (3/?S0 8 locations) is the most general DECtape 
handler provided. It has a simultaneous three- 
file capacity, either input or output. Input files 
can be referenced on the same or different DECtape 
units; however, not more than one output file can 
exist on the same unit. (I.e., file creation on 
the same unit must occur sequentially.) 

• DTC (1264g locations) is the most limited and also 
the most conservative of core (for IOPS data mode 
operations) of the handlers. It is an input only 
handler with a one-file capacity. 

• DTD (3071g locations) provides single file operation, 
either input or output. 

• DTE C2674g locations) is similar to DTD, differing 
only in its I/O function capabilities as shown in 
Table 9-10. 


Maximum I/O buffer size returned: 64 0 (52. .) . 

o 10 
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• DTF CllSlg locations) is a handler which simulates 

the non-director ied , sequential access file structure 
of Magtape. It accommodates (serially) up to eight 
DECtape units, both input and output. When the last 
block of a tape on a particular unit has been accessed, 
DTF causes the Monitor to output an I0PS4 message 
(Device Not Ready) to permit the operator to remove 
the current tape from the DECtape drive and mount 
another. The operator can then type a CTRL R to con- 
tinue processing. 


Table 9-9 illustrates the data modes which are acceptable to these 
handlers, while Table 9-10 shows the handlers' responses to the vari- 
ous I/O Macros. 

Table 9-9 


DECTAPE DATA MODES 


Data Mode 

Handler 

DTA 

DTC 



DTF 

IOPS ASCII 



X 


X 

IOPS Binary 

X 

X 

X 

X 

X 

Image 

Alphanumeric 

X 

- 

X 

X 

- 

Image Binary 

X 

- 

X 

X 

- 

Dump 

X 



X 

X 

1 


9. 3. 4. 2 Device Dependent Characteristics - The following character- 
istics are unique to the DECtape Handlers in their responses to certain 
I/O Macros. 

a. . INIT - Maximum I/O buffer size returned: 377g (255 -^q) . 

b. .MTAPE 1) DTD accepts REWIND and BACKSPACE RECORD 

subfunctions only. 

21 DTF accepts REWIND, BACKSPACE RECORD and 
SKIP RECORD subfunctions only. 
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Table 9-10 

DECTAPE I/O FUNCTIONS 



9.3.5 DECdisk, Disk Cartridge and Disk Pack Handlers (DKA/RKA/DPA, 
DKB/RKB/DPB, and DKC/RKC/DPC) 

9. 3.5.1 General Description - Three handlers are provided for RF15 
DECdisk, RK05 Disk Cartridge and RP02 Disk Pack operations. Version 
for version, these handlers are identical in their functions with 
these two exceptions : 

a. All disks DECdisk, Disk Cartridge and Disk Pack are 
block addressable for direct access operations 
(.TRAN and . RTRAN Macros). Also, the DECdisk 

is word addressable. 

b. The Disk Pack and Disk Cartridge have a unit structure 
while the DECdisk does not. This means that each DECdisk 
is treated as a single addressable unit regardless of the 
actual number of platters incorporated (up to 8) . 
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All versions of these handlers support the disk file structures de- 
scribed in Chapter 3 . There is no fixed limit to the number of input 
or output files which can be simultaneously accessed, except as deter- 
mined by the amount of available buffers. To this end, the handlers 
perform dynamic buffer allocation from the Monitor's buffer pool, using 
the .GTBUF and .GVBUF Monitor Macros described in Chapter 5. At run 
time, the operator need only be concerned that the number of files con- 
currently accessed is not greater than the number of buffers allocated 
by the BUFFS Keyboard command (see 8.6.1). 

The following commands obtain buffers from the pool, and return them 
immediately upon completion of the operation: 

.DLETE 

.RENAM 

.CLEAR 


The following commands obtain a buffer from the pool and do not return 
it until a subsequent .CLOSE, . INIT or Rewind ( .MTAPE) is performed: 

.FSTAT 

.ENTER 

.SEEK 

.RAND 


following commands return a buffer to the pool, if any were taken. 


.INIT 

.CLOSE 

.MTAPE (.Rewind subfunction) 

The handlers operate in all data modes (i.e., IOPS, Image, and Dump). 
Table 9-11 lists the I/O Macros which are acceptable to the various 
handler versions. 
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Table 9-11 

DECDISK, DISK CARTRIDGE AND DISK PACK I/O FUNCTIONS 



9.3. 5.2 Device Dependent Characteristics - The following character- 
istics are unique to these handlers in responding to certain I/O Macros: 

a. . INIT 

1) Maximum I/O buffer size returned: 376 g ( 2 5 4 ^ Q ) . 

2) The disk handlers allow write verification on output files. 

If the file is defined as an output file, the user has the 
opportunity of guaranteeing the integrity of his data by 
using ll g as the "dd" argument to the .INIT macro. The 
handler will then check \ every block of data it writes 
out, to ensure that the transfer occurred without error. 

A second .INIT command must be executed to remove or add 
the write checking feature. (i.e., repeated llg argument 
causes write check switch 1 to be turned ON/OFF/ON/OFF/ON..) 

3} An output file already opened on a .DAT slot referenced by 
.INIT will be deleted. If a .INIT references a .DAT slot 
with an opened input file, the handlers will close it, 
and give back the buffer it was using. 

4) Control is retained until all necessary I/O is complete. 

5) The .INIT macro uses the relationship between the User 
File Directory Table and the Device Assignment Table to 
get the correct UIC from the User File Directory Table. 

If the user is changing UIC's under program control (via 
.USER macros), the operation must be accomplished before 
a .INIT in order to obtain the desired UFD. 

^Sizes listed are approximate. 
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b. . DLETE 

1) Control is not returned until all necessary Disk I/O is 
complete. If the UIC associated with this .DAT slot 
does not exist in the MFD, or if the named file can not 
be found, the disk handlers ignore this macro. If the 
name is found, the handlers return the first block num- 
ber of the file in the AC. The buffer used by the hand- 
lers to delete the named file is given back to the buf- 
fer pool upon completion of the .DLETE. 

2) The .DLETE macro follows the protection rules for di- 
rectory modification. That is, .DLETE will not work on 
a protected directory, but returns an IOPS 63 error. 


c . . RENAM 

1) The first block number of the renamed file is returned 
in the AC after a successful operation. If the file or 
UFD does not exist, the handlers return to LOC+3 with 

0 in the AC. .RENAM changes the renamed file's date to 
the current date (maintained by the DATE keyboard command 
described in Chapter 8) . 

2) At completion of the .RENAM function, the handlers re- 
turn the buffer to the buffer pool. 

3) The .RENAM macro follows the protection rules for 
directory modification. That is, .RENAM will not work 
on a protected directory (IOPS 63) . 

d. .ENTER 

1) The handlers check for directory protection. If any of 
the following conditions is satisfied, the handlers will 
allow successful operation. If none is satisfied, the 
handlers will terminate with an IOPS 63. 

Conditions for gaining UFD access: 

Entry in .UFDT equals the logged-in UIC 

Logged-in UIC equals MIC 

Directory protection code equals 0 

2) Once the entry in the UFD has been made via the .ENTER, 
the file is defined as being opened and truncated. Upon 
a subsequent .CLOSE, the file will exist as a closed 
file, but not truncated. 

3) When a .ENTER is done with a file name that already 
exists, the old file is deleted only after the new 
file (just .ENTERed) is .CLOSEd, if the old file is not 
truncated. If the old file is a truncated file, it is 
deleted immediately, before the new file is listed in 
the UFD. The process of deletion of identically named 
truncated files continues until a non-truncated file 
with the same name is found. At this point, the new 
directory entry is made. Truncated files which follow 
are not deleted. In all cases, UFD searches are 
sequential starting at the beginning. 
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e. .CLEAR 

1) The disk handlers will not honor .CLEAR unless the user 
has logged in under the MIC. The .CLEAR function deletes 
all files and directories on the entire disk. All bit maps 
are closed and indicate only the space which they occupy. 
The MFD will have no UFD's, SYSBLK or BAT. An I/O buffer 
is obtained from the pool for this operation and is subse- 
quently returned on its completion. 

f. .CLOSE 

11 On input, the handlers give the buffer back (if 

one was acquired) and make the .DAT slot available 
for subsequent . INITs . On output, the handlers 
write an end-of-file record (if the user did not 
already write one) , and then proceed as on input. 

g. .READ 

1) All .READ commands executed after an end-of-file 
(EOF) header has been reached will return an EOF 
in header word 0 ( 001005 ) . 

h. . MTAPE 

1) DKA, RKA and DPA accept the REWIND and BACKSPACE 

subfunctions during input only. REWIND is effectively 
a .CLOSE. 

i . . TRAN 


1) The .TRAN is not included as part of the disk file 
structure. That is, all blocks read or written are 
done so at the user's discretion. MFD ' s , UFD's, 

Bit Maps, and RIB's are not considered, and are not 
protected from the .TRAN macro. The .TRAN macro is 
allowed to any .DAT slot that has been .INITed, and 
not .CLOSEd or rewound (via a .MTAPE) . 


2) For the RF DECdisk, the user can reference a specific 
platter just by identifying the block number he 
wants. The block numbers and platter relationships 
are shown below: 


Platter Number 

0 

1 

2 

3 

4 

5 

6 
7 


Block Number 

0-1777 

2000-3777 

4000-5777 

6000-7777 

10000-11777 

12000-13777 

14000-15777 

16000-17777 


j. . FSTAT 

1) .FSTAT functions normally, except that a subsequent .SEEK 
to a file found via .FSTAT will not require redundant disk 
access. That is, both .FSTAT and .SEEK ordinarily require 
a minimum of three disk accesses — one to the MFD, one to 
the UFD, and one to the file. If the user does a .FSTAT to 
an existing file, and then a .SEEK, the disk handlers 
"remember" the successful .FSTAT, and do not do an extra 
disk access. 
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k. .RAND 

1) .RAND commands to a nonexistent file cause an I0PS13. 
Those to a nonexistent UFD cause an I0PS51. Those to 
an empty UFD cause an I0PS71. 

l . . RTRAN 

11 The disk pack and disk cartridge handlers ignore the 
word number argument (assumed to be 0 ) and return the 
whole block. If the word number plus the word count 
exceeds 254^ Q , the disk handlers will return IOPS67. 

Output .RTRAN to the RP or RK disk requires 256 10 -word 
buffers to allow the handlers to supply the correct 
links in the last two words. (Otherwise, random 
files would require two buffers from the pool.) 

If the block number argument requested by the .RTRAN 
is less than one, or greater than the number of blocks 
in the file, an IOPS66 will result. 

9.3.6 Magtape Handlers (MTA, MTC , and MTF) 


9.3. 6.1 General Description - Three handlers are provided for operation 

of Magtape drives TU10, TU20A, TU20B , TU30A, and TU30B. These handlers 

permit control of up to eight transports. The sizes shown are approx- 
imate. 


• MTA (4703 ) locations) is the most general and permits 

O 

DECtape file structuring using .SEEK and .ENTER Macros 
(refer to Chapter 4) . Up to three files can be con- 
currently referenced, each on a different transport, 
either input or output. 


• MTC (1253 ft locations) is a read-only handler designed 
for operation using DECtape file structuring only. 

It has a single file capacity; sequential file refer- 
ences are, of course, allowed. 

• MTF (1312g locations) is designed for Magtape file 
structuring only. It accommodates up to eight con- 
currently referenced transports, both input and output. 


The track count (either 7- or 9-channel) can be set at System Genera- 
tion, or by using the CHANNEL Keyboard Command. In addition, it can 
also be set dynamically, along with parity and recording density param- 
eters, using the .MTAPE I/O Macro (see paragraph 6.7.7) when using 
Magtape file structuring. When using DECtape file structuring, parity 
and density are fixed at odd parity and 800 BPI recording density. 


Table 9-12 lists the Data Modes acceptable to the handlers and Table 
9-13 lists the I/O Macros and their responses. 
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Table 9-12 


MAGTAPE DATA MODES 


Data Modes 

Handler 1 

MTA 

MTC 

MTF 

IOPS ASCII 

X 

X 

X 

IOPS Binary 

X 

X 

X 

Image 

Alphanumeric 

X 

- 

- 

Image Binary 

X 

- 

- 

Dump 

X 

- 

- 


Table 9-13 

MAGTAPE I/O FUNCTIONS 


Macro 

Handler 

MTA 

MTC 

MTF | 

. INIT 


\ 

Accept 

Acc 

ept 

. FSTAT 

1 

Accept 

i 


i 

i 

.RENAM 



Ille 

:gal 



. DLETE 

1 

1 





.RAND 

Illegal 



Ille 

gal 

. RTRAN 

I Ill€ 

! 

jgal 

i 




.SEEK 

i 

i 

Accept 



. ENTER 

j 


Illegal 



.CLEAR 



Illegal 

1 

r 

.CLOSE 



Accept 

Acc 

ept 

.MTAPE 

Acc 

apt 

Illegal 



.READ 



Accept 



.WRITE 



Illegal 



.WAIT 



Accept 



. WAITR 



Accept 



.TRAN 


r 

Illegal 

1 

f 


Illegal = Illegal Function (I0PS6 Error) 
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9. 3. 6. 2 Device Dependent Characteristics - The first .INIT to a Mag- 
tape unit causes the system default parameters for track count, re- 
cording density, and parity to be assigned as follows: 

Parity odd - Density 800 BPI 

Track Count - System Generated Default unless otherwise speci- 
fied in the CHANNEL Keyboard Command. (See 
Paragraph 8.9.3.) 

The following characteristic is unique to the operation of the A and 
C handlers in responding to the I/O Macros below: 

a. .INIT - Maximum I/O buffer size returned: 376_ (255..). 

O 10 

The following describes characteristics which are unique to the oper- 
ation of the MTF handler. 

CHANGING THE BUFFER SIZE 


The user may dynamically change the standard buffer size (377 g returned 
on .INIT) with the following instructions: 

. GLOBL MTBSIZ 


LAC BUFSIZ / (Any desired buffer size) 
DAC* MTBSIZ 


WRITE 

.READ 

Thus, since FIOPS re .INITs a handler every time I/O transfer direction 
is changed, one can input from Magtape drive N with one record size 
and output to drive M with another record size, bearing in mind that 
MTBSIZ must be altered before transfer direction is changed. Record 
size must be less than or equal to 256 words for FORTRAN .READS and 
.WRITES. Larger record sizes are possible via MACRO routines. 

. INIT 

1. Return standard buffer size of 377_ words. Buffer size can 

O 

be changed by modifying the .GLOBL MTBSIZ through a call to 
a MACRO subroutine. 
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2. Call .SETUP - API channel register 45g. 

3. Set up transfer direction (input or output) . 

4. If first . INIT to this device, the assigned default values 
will be odd parity and 800 BPI . Track count will be speci- 
fied by bit 6 of the SCOM+4 register. ( 0=1 channel, 1+9 
channel . ) 

5. Update the reference drive table to indicate this unit is open 
for I/O transfers. 


. OPER - .FSTAT is allowed and implemented. AC=0 on return. 

. SEEK - Undefined. Error return I0PS6. 

. ENTER - Undefined. Error return I0PS6. 

. CLEAR - Undefined. Error return I0PS6. 

.CLOSE 

1. Checks transfer direction. If not output, an error return 
I0PS6 is issued. 

2. Writes an end-of-file mark and returns to caller. 


. MTAPE - Honors the subfunction specification as follows: 


00 

01 

02 

03 


04 

05 

06 
01 


10 17 


Rewind : A rewind is issued to the specified drive and con- 

trol is returned to the caller. 

Undefined : Error return IOPS6. 

Backspace : A backspace is issued to backspace one physical 

record . 

Backspace file : Issue backspace until two end-of-file marks 

have been passed over, then space forward over the last end- 
of-file mark. If beginning of tape is sensed during the 
backspacing, the function is terminated and control is re- 
turned to the caller. 


Write EOF : Issue a write end-of-file mark. 

Forward space: A space forward is issued to forward space 

one physical record. If the end-of-tape is sensed, an error 
return IOPS65 is issued. 

Forward space file : A space forward is issued to forward 

space until an end-of-file is sensed. If the end-of-tape is 
sensed, an IOPS65 is issued. 

Space to logical EOT : A space forward is issued until two 

consecutive end-of-file marks are passed, then a backspace 
one physical record is issued. If the end-of-tape is sensed, 
an IOPS65 is issued. 


Describe the tape configuration . The reference drive table 
will be updated for the unit referenced. Subsequent I/O 

4 - -£T T r4 1 1 vs v* ^*s v—rrs^/3 4 V>, +-V>£=s ^0^01 ftT 1 ri3 T* 1 +“ V ^ Tt H 

ui_ o.ut> j_ ei £5 wo..- ■ — — — 


channel count given below: 
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Channel 


Subfunction Count 


10 7 

11 7 

12 7 

13 9 

14 7 

15 7 

16 7 

17 9 


Parity 

Dens i tv 

Even 

200 

BPI 

Even 

556 

BPI 

Even 

800 

BPI 

Even 

800 

BPI 

Odd 

200 

BPI 

Odd 

556 

BPI 

Odd 

800 

BPI 

Odd 

800 

BPI 


.READ 

1. Check if the referenced unit is allowed to input. Error 
I0PS6 is issued if not. 

2. Check if the data mode is legal: mode 0 or 2. Error return 

I0PS7 is issued if the data mode is illegal. 

3. Initiate the data transfer. 

4. Read errors: 

a. Parity, checksum, and record length incorrect . The 
appropriate header bits are set and returned to the data 
buffer . 

b. Bad tape or data late . These are considered unrecoverable 
tape errors, and an error return IOPS65 is issued. 

c. End-of-f ile . The appropriate header bits are set to a 5 
and returned to the data buffer. 

d. End-of-tane . The appropriate header bits are set to a 6 
and returned to the data buffer. 

e. Any Real Error (parity, data late, or bad tape) is 

given 25 rereads before error action is taken. 

.WRITE 

1. Check if referenced unit is allowed to output. Error return 
I0PS6 is issued if not. 

2. Check if the data mode is legal: mode 0 or 2 . Error return 

I0PS7 is issued if the mode is illegal. 

3. Initiate the data transfer. 

4. Write errors: 
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a. Any write error is given 25 rewrites. If unsuccessful, 
six inches of tape are skipped and the record is rewritten. 

b. End-of-tape . The appropriate header bits are set to 6 
and returned to the data buffer. 


.WAIT, .WAITR - Check I/O underway. 

1. Busy : Return to CAL or to address in CAL+2 (.WAITR). 

2. Nonbusy : Return to CAL+2 or to CAL+3 (.WAITR). 

3. After a .WAIT or a nonbusy .WAITR, the accumulator contains 
the contents of the TC59 magnetic tape status register as it 
appeared on completion of the previous I/O operation. 

.TRAN 

Allows standard core dump mode (both 7 and 9-track look like 7-track) , 
and true 9-track mode. Bit 9 of LOC+0=1 yields true 9-track. 

Nine-track data arrives in core with parity set in bits 0 and 1, and 
with two 8-bit bytes in the low-order 16 bits, as follows: 


A parity B parity 



LEGAL DATA MODES 

Output - IOPS BINARY (Mode 0) and IOPS ASCII (Mode 2) - The checksum 
is completed and stored in the second word of the line in the IOPS 
buffer area. Bits 12-13 of the first header word are set to zero. 

The count of words to write is taken from the word pair count in the 
header and transfer from the IOPS area is initiated. 

Input - IOPS BINARY (Mode 0) and IOPS ASCII (Mode 2) - The count of 
words to transfer is taken from the CAL sequence and input is initiated 
from the next physical block on the tape directly into the IOPS buffer 
area. When the read is complete, the line validity bits are modified 
under the following conditions: bits 12-13 of header word 0 are set 

if buffer overflow occurred. A checksum is calculated and compared 
with the checksum read. If they differ, bits 12-13 are set to 10. 
Finally, a check is made to assure that the line was transferred with- 
out hardware-detected error. If an error occurred, bits 12-13 are set- 
to 01 . 
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RECOVERABLE ERRORS 


Transport not ready. IOPS4 

1 . Results from : 

a. Write request with write lock. 

b. Nine-channel I/O request to a 7-channel transport, and 
vice versa. 

c. Transport off line or otherwise not ready. 

2 . Remedy : 

a. Ready the device. 

b. Type control R on the teletype. 

UNRECOVERABLE ERRORS 


1 . 

Illegal function. I0PS6. 




2. 

Illegal data mode. I0PS7. 




3. 

End-of-tape encountered on a file 

spacing 

command . 

IOPS44 . 

4. 

Unrecoverable Magtape error (data 

late or 

bad tape) 

. IOPS65 


9.3.7 Line Printer Handler (LPA) 


9. 3. 7.1 General Description - LPA ( 5 3 3 _ ) locations for the LP15 ver- 

b 1 

sion and 657 g locations for the LP11 version are designed to operate 
the 80-column and 132-column LP15 and LPll Line Printers respectively. 
The sizes shown are approximate. The handlers accept data in either 
TOPS ASCII or Image Alphanumeric data modes. Table 9-14 lists the 
various I/O Macros and the handlers' response to them. 

Table 9-14 


RESPONSES TO LINE PRINTER I/O FUNCTIONS 


Accept 

Illegal 
(IOPS 6) 

Ignore 

. INIT 

.RAND 

. FSTAT 

.CLOSE 

. RTRAN 

.RENAM 

.WRITE 

. SEEK 

. DLETE 

.WAIT 

• READ 

.ENTER 

. WAITR 

.TRAN 

. CLEAR 



. MTAPE 


The LPll version also supports the LS11 Line Printer and the LV11 
(as a printer and only when connected to the LPll printer interrupt 
vector) . 
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9. 3. 7. 2 Device Dependent Characteristics - The following paragraphs 
describe characteristics which are unique to the Line Printer Handler 
in its response to certain I/O Macros and characters. 

a. . INIT - 1) Maximum I/O buffer size returned: 70g (56 -^q) for 

132 column printers; 44g (36 ^q) for 80 column 
printers. 

2) Output FORM Feed. 

3) Test Bit 6 of the .INIT CAL (see 6.7.6). If this 
bit is zero, the handler will perform automatic 
paging by outputting a form feed after every 57 ^q 
lines. (This bit is set by using a 5 rather than 
a 1 in the "dd" argument of the .INIT.) 

b. .CLOSE - Output a FORM Feed (if not inhibited in the .INIT)* 

c. .WRITE - 1) Examine header word 0 in the user's I/O 

buffer as follows: 

Bit Meaning 

0 0 = Enter Single Line Mode 

1 = Enter Multiple Line Mode 

1-8 Contains Line Count for 

Multiple Line Mode 

14-17 Data Mode 

2 = IOPS ASCII 

3 = Image Alphanumeric 

21 Check the first character of the user's I/O 
buffer for the following vertical form con- 
trol characters, all of which are output 
by the FORTRAN IV Object Time System: 

014 FORM Feed 

020 Overprint 

021 Print every second line 

012 Line Feed 

To effect the Overprint function for FORTRAN 
users, it is necessary to simulate certain 
vertical form control characters. If the 
first character of a line is 012, 014, or 021, 
the handler automatically enters Multiple Line 
Mode (by setting bit 0 of the first word in 
the user's I/O buffer to 1) and prints two 
lines, the first line being the vertical con- 
trol character, and the second line being the 
actual data. If the first character is 020 
(overprint), it is replaced in the user's 
I/O buffer by 015 (Carriage Return) which 
does not affect the page position and both 
lines are printed. All other characters cause 
a Line Feed to be output from the handler's 
internal buffer followed by the line from the 
user's buffer. After output, any data in the 
user's I/O buffer which was changed (i.e., header 
word 0 or the first data word) is restored. 
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If the user intends to output to another device 
from the same I/O buffer (e.g., two sequential 
.WRITES) , a .WAIT should be used after the .WRITE 
referencing the Line Printer to permit the re- 
storation of any data which may have been replaced 
in the user's I/O buffer by LPA. 

3) Output in either Single Line Mode or Multiple 
Line Mode as applicable. 

4) Restore modified portions of the user's I/O 
buffer (if changed) . 

d. Carriage Control Characters - The control characters in Table 
9-15, except horizontal TAB, cause line termination, in both 
IOPS and Image Modes, except for special cases described under 
.WRITE above. 

Table 9-15 


LINE PRINTER CARRIAGE CONTROL CHARACTERS 


Character 

Action 

Line Feed 

(012) 

Space one line 

VT (Vertical Tab) ($13) 

Space 20 lines 

Form Feed 

(014) 

Move to top of form 

Carriage Return (015) 

Reset column count to zero (no implicit 



LINE FEED function) 

DLE (020p 


Overpoint 

DCl (021) 

Refer to Ap- 

Space 2 lines 

DC 2 (022) 

^ pendix A for 

Space 3 lines 

DC 3 (023) 

alternate 

Space 1 line 

DC4 (024)^ 

designations 

Space 10 lines 

ALT MODE (175) 

Reset column count to zero (no implicit 



LINE FEED function) 

Horizontal 

Tab (011) 

Output sufficient number of spaces to 



position printer at column 9, 17, 25, 



. . . , etc . This is not a line terminator 



and may occur anywhere in the line. 


NOTE 1 

The user is provided with the facility of halting 
the output on the LP11/LS11 Line Printer (in a 
UNICHANNEL-15 system) at the end of the current 
file (CLOSE causes the end of file condition) in 
the spooled mode. This permits the user to per- 
form operations like tearing off the output list- 
ing, changing paper, etc. This is enabled through 
console switch 1 on the PDP-11. The user requests 
the PIREX system to halt output on the line printer 


1 For UCl 5 or UC15 


Option Systems only. 
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at the end of the current file by setting the 
PDP-11 switch in the 'UP' or '1' position. The 
system periodically monitors this switch. When 
PDP-11 switch 1 is in the 'DOWN' or 'O' position, 
the system resumes output to the line printer 
shortly thereafter. 

9.3.8 Card Reader Handler (CDB) 

9. 3. 8.1 General Description - CDB is designed to operate the CR03B 
(770 g locations), CR15 (1000 g locations) and CR11 (613 g locations) 
card readers respectively. Sizes shown are approximate. The handler 
transmits data in IOPS ASCII mode only. As initially supplied, it 
interprets Hollerith code as punched in DEC029 Card Code. CDB is 
also supplied in source form which can be assembled to produce a 
version of the handler which interprets Hollerith punched in DEC026 
Card Code 1 . Appendix F contains a table of 029 and 026 Hollerith 
Codes and the corresponding IOPS ASCII codes. Table 9-16 lists the 
handler's response to the various I/O macros. 


Table 9-16 


CARD READER I/O FUNCTIONS 


MAcro 

Response 

. INIT 

Accept 

. FSTAT 

Ignore 

. RENAM 

Ignore 

.DLETE 

Ignore 

.RAND 

Illegal 

. RTRAN 

ILlegal 

.SEEK 

Ignore 

. ENTER 

Illegal 

. CLEAR 

Illegal 

.CLOSE 

Accept 

.MTAPE 

Ignore 

.READ 

Accept 

.WRITE 

Illegal 

.WAIT 

Accept 

. WAITR 

Accept 

.TRAN 

Illegal 


Illegal = Illegal Function (IOPS6 Error) 
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for assembling and installing CDB. 
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9. 3. 8 . 2 Device Dependent Characteristics - The following paragraphs 
describe the characteristics which are unique to the Card Reader 
Handler in its response to certain I/O Macros. 

a. . INIT - Macimum I/O buffer size returned: 44 0 (36 nn ) 

O J. (J 

b. .READ - Eighty card columns are read and interpreted as 
029 or 026 Hollerith data, mapped into the corresponding 
64-graphic subset of ASCII, and stored in the user's I/O 
buffer in 5/7 format (36^ g locations are required to store 
an 80 column card) . Compression of internal blanks to tabs 
and truncation of trailing blanks is not performed (all 

80 characters appearing on the card are delivered to the 
user's buffer). In addition, a Carriage RETURN (015) char- 
acter is appended to the input line; thus, a total of 81 
characters are returned to the user. 

c. Illegal punch configurations - all illegal punch configura- 
tions (i.e., those not appearing in the 029 or 026 character 
set shown in Appendix F) are interpreted as validity errors 
and will cause an IOPS 4 error condition. The card contain- 
ing the error must be repunched. 

d. Special Codes - In addition to the Hollerith character set, 
the handler recognizes the ALT MODE terminator which is 
necessary for some system programs. ALT MODE, recognized 
as a 12-8-1 code (multiple-punched A8) is mapped into the 
standard ALT MODE character (175 g ) in the user's buffer. 

Each file must be terminated with an EOF card punched in 
either of two ways: a) multiple punch the characters 

+-0123456789 which punches all positions in card column 1, 
or b) multiple punch characters A0- which produces a 
12-11-0-1 punch in card column 1. 


9.3.9 VP15A Storage Tube Display (VPA) 

VPA operates the VPl 5 A Storage Tube Display. It accepts data in IOPS 
ASCII, Image Alphanumeric and Dump Modes. In IOPS ASCII and Image 
Alphanumeric Modes, up to 70 o (56 1A ) 72-character lines can be dis- 
played. In Dump Mode, the handler interprets each 18-bit word as a 
coordinate for point plotting operations. The binaries of VPA.S and 
VPA. are produced from the same source: VPA. xxx, where xxx is the 

current edit number. Two versions of VPA are provided. The version 
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called VPA. (1260g locations) automatically erases the screen when an 
attempt is made to display the 57th ASCII line and that line is placed 
at the top of the screen. The other version of VPA, which has a file 
name VPA.S, is slightly larger (1266g locations). Sizes shown are 
approximate. It permits the user to operate the display in a "paging" 
mode by setting console data switch 0 (when set to 1 ) to inhibit fur- 
ther output once the 56th ASCII line is displayed. Operation is re- 
sumed by pressing the ERASE pushbutton. Paging is stopped by resetting 
console data switch 0 to 0 ^ . 

Table 9-17 lists the handler's response to the various I/O Macros. The 
user should refer to the VP15A XVM Graphics Software Manual for a de- 
tailed description of the handler's capabilities and programming con- 
siderations . 


Table 9-17 

VP15A DISPLAY I/O FUNCTIONS 


Macro 

Response 

. INIT 

Accept 

. FSTAT 

Ignore 

. RENAM 

Ignore 

.DLETE 

Ignore 

.RAND 

Illegal 

. RTRAN 

Illegal 

.SEEK 

Illegal 

. ENTER 

Ignore 

.CLEAR 

Ignore 

.CLOSE 

Accept 

. MTAPE 

Ignore 

• READ 

Illegal 

.WRITE 

Accept 

.WAIT 

Accept 

. WAITR 

Accept 

.TRAN 

Illegal 


Illegal = Illegal Function (I0PS6 Error) 


Refer to the XVM/DOS VIA System Installation Guide for procedures 
for installing the VPA.S or VPA. 
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9.3.10 UC15 XY11/XY3 1 1 PLOTTER (XYA) 

XYA (approximately 1145 g locations) drives a pen-type plotter interfaced 
onto the PDP-11 in UNICHANNEL-15 systems. The legal data modes are 
IOPS ASCII and IOPS BINARY. 

IOPS ASCII is purely for character plotting. The characters have the 
size and orientation specified by the last "set character attribute" 
call (mode=10) . The default setting calls for characters to be drawn 
each in 1/5" square box, in a horizontal direction. The box includes 
the intercharacter spacing, so that adjacent boxes touch. Horizontal 
is the length of the plotter paper roll, with the feed roll the di- 
rection of positive X. The ASCII characters of value 40-137 octal 
are plotted. Those below 40 (blank) are replaced by blank; those 
140-177 are mapped back to 100-137. Thus, a lower case "a" is plot- 
ted as an upper case "A". Note that this means that carriage return, 
line feed, etc., have no meaning on the plotter. IOPS ASCII output 
can be obtained, for instance, from FORTRAN FORMAT statements. 


IOPS BINARY writes are used to output data and control information 
to the plotter. The format of integer data in the buffer is a mode 
variable followed by several optional variables. The variables are 
integer. Co-ordinate addresses are in plotter steps (1/100") . 

MODE FUNCTION ADDITIONAL VARIABLES 1 


0 

pick up the pen 

none 


1 

put down the pen 

none 


2 

pen up, move to absolute 


9 


position 

IX, IY 

[ , IX, IY , . . .] Z 

3 

pen down, move to absolute 


O 


position 

>-• 

H 

x 

H 

[ , IX, IY , . . . J 

4 

pen up, move relative to 




present position 

IX, IY 

[ , IX, IY , . . . ] Z 

5 

pen down, move relative 


o 


to present position 

IX, IY 

[ , IX , IY , . . . ] ^ 

6 

draw characters from array 

ICNT, ARRAY 

7 

present pen position de- 


2 


fined as co-ordinate 

IX, IY 

[ , IX, IY , . . . ] 

8 

move to absolute position 


2 


(no pen change) 

IX, IY 

[ , IX, IY , . . . ] 

9 

move relative to present 




position (no pen change) 

IX, IY 


10 

set character 

IX, IY, 

ISIN, ICOS 

11 

set XY311 pen (1, 2, or 3) 

IPEN 



1 The mode and additional variables are simply the data referenced by 
a .WRITE MACRO, or a FORTRAN WRITE operation. 

2 

Up to 126 ^q vector co-ordinate pairs may be specified on a single 
output request. 
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where IX is the horizontal size of the box surrounding each character, 
in plotter steps, and IY is the vertical size. ISIN and ICOS are 
integers to describe rotation of the character string counter-clock- 
wise from the horizontal position. ISIN is the sin of the angle times 
65536^^, and ICOS is the cosine times 65536^. 

Interface routines may easily be written in FORTRAN to emulate a 
given plotter package. A CALL with certain arguments places those 
arguments in a .WRITE to the plotter. Scaling of inches to plotter 
steps should also be done here, if necessary. 


UCl 5 CALCOMP PLOTTER I/O FUNCTIONS 


MACRO 

RESPONSE 

.INIT 

Accept 

.CLEAR 

Ignore 

.CLOSE 

Accept 

. DLETE 

Ignore 

. ENTER 

Ignore 

. FSTAT 

Ignore 

.MTAPE 

Illegal 

.RAND 

Ignore 

.READ 

Accept 

.RENAM 

Ignore 

. RTRAN 

Ignore 

• SEEK 

Illegal 

.TRAN 

Illegal 

.WAIT 

Accept 

. WAITR 

Accept 

.WRITE 

Accept 


Illegal results in IOPS 6 error message 


A . INIT (issued by FORTRAN) lifts the pen, sets the default character 
attributes, and set present X, Y to '0,0’. .INIT returns buffer 
size of 400g. The maximum character string accepted is 204g char- 
acters. Buffers larger than this are ignored with no error message. 

A .READ returns in IOPS BINARY seven words (eight for XY311) of handler 
status. (Note, in the case of spooling, this status may not yet have 
been obtained by the plotter itself.) 
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1) present X co-ordinate in plotter steps 

2) present Y 

3) horizontal character size 

4) vertical " " 

5) ISIN for character rotation, format given above 

6) ICOS for 

7) 0 is pen up, 32768 -j_q if down. 

8) current pen selected (for XY311 only) 

For instance, from FORTRAN: 

READ (7) LASTX, LASTY, ISX, ISY, ISIN, ICOS, IPEN, ISEL 

MACRO users note that the first returned word is an octal 
400000 for FORTRAN. 

.CLOSE forces the handler to send to the PDP-11 any writes held in 
the handler. Normally, 10 decimal writes are grouped together to 
make up one buffer which is sent to the PDP-11. 


A FORTRAN STOP statement will force a .CLOSE automatically. 


NOTES: 

It is possible to direct plotter output to a file on the disk, for 
instance. This file can then later be PIP-ed in IOPS binary mode to 
the plotter. Plotter files to be PIP-ed must be in the IOPS binary 
mode only. 

The offline switch for the plotter is switch #2 of the PDP-11 console 
switches, regardless of whether spooling is enabled or not. The 
plotter will stop when the switch is raised, and resume when lowered. 
An IOPSUC XYU 4 message (indicating offline) at the console is for 
information only, it is neither necessary nor possible to resume 
plotter operation by typing CTRL R. 

The user is provided with the facility of halting the output on the 
XYl 1 plotter (in a UNICHANNEL-15 System) at the end of the current 
file in the spooled mode. This permits the user to perform opera- 
tions like positioning plotter pen on paper, changing pen/paper, etc. 

PDP-11 Console switch 3 on the PDP-11 is used for this purpose. The 
user requests the PIREX system to halt output on the plotter at the 
end of the current file by setting PDP-11 switch 3 to the 'UP' or 1 1' 
position. The system periodically monitors this switch. When PDP-11 
switch 3 is in the 'DOWN' or '0‘ position, the system resumes output 
on the plotter shortly thereafter. 
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The XY1 1 plotter is 100 steps per inch with an 11-inch width. The 
XY311 plotter is 500 steps per inch with a 30-inch width. The X axis 
is in the direction of the paper roll. The character modes handle 
their own pen up-down. To initialize the plotter (XY11) ; 

C PUSH PEN TO PAPER EDGE 

IM=4 

IX=0 

IY=-120J0 

WRITE (7) IM,IX,IY 

C ESTABLISH CO-ORDINATES 

IM=7 

IY=0 

WRITE (7) IM,IX,IY 

The first write in MACRO would be; 

.WRITE 7,0, BUFF, 3 
.WAIT 7 

BUFF 3000 
0 
4 
0 

775520 
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XVM IOPS ASCII STANDARD CHARACTER SET 

The following table shows the 7-bit ASCII characters interpreted by the 
XVM/DOS Monitor and System Programs either as meaningful data and com- 
mand input or as control characters. The 7-bit octal code and the 
corresponding graphic characters conform to the standard ASCII 1968 
64-character graphic subset. 

The control characters (codes 00-37, and 175-177) are used for system 
control purposes. The characters shown in brackets are not used by 
the system and are available for user applications. Characters in 
parentheses denote the 1963 character set. 
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7-BIT 

ASCII 

7-BIT 

ASCII 

7-BIT 

ASCII 

7-BIT 

ASCII 

CODE 

i 

CHAR. 

r — • 

CODE 

CHAR. 

it. 

CODE 

... 

CHAR. 

CODE 

CHAR. 


ETX (CTRL C) 
EOT (CTRL D) 
ENQ “ 

ACK 
BELL 
_ BS 
HT 
LF 
VT 
FF 
CR 


140 Not 
$ recognized 
174 by XVM/DOS 
175') 

1? g| ALT MODE 
177 DEL(rubout) 


~SO 

_SI_ 


DLE (CTRL P) 
DC1 (CTRL Q) 
DC 2 (CTRL R) 
DC 3 (CTRL S) 
DC4 CTRL T) 
NAK (CTRL U) 

r synh 

|_etb J 

CAN (CTRL X) 


[EM 1 
LsubJ 


033 ESC (ALT MODE) 073 ; 133 [ 

034 (“ FSl 074 < 134 \ 

035 GS 075 = 135 ] 

036 RS 076 > 136 ~(t) 

037 L US J 077 ? 137 (^) 

NOTES: 1. Codes 33, 175 . a nd 17 6 are interpreted as ESC (ALT MODE) and 
are converted on Input to 175 by TOPS. 

2. The left bracket, backslash, and right bracket 
(i. e. [, \ ,and ]) characters are formed by typing 
SHIFTS K, L, and M, respectively, on Teletypewriters. 
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APPENDIX B 

SAMPLE IOPS ASCII PACKING AND UNPACKING ROUTINES 

This appendix contains two subroutines for use in packing and unpack- 
ing IOPS (5/7) ASCII. These routines are self-contained and can be 
incorporated in user programs directly or contained in the XVM/DOS 
System Library (.LIBR BIN) or user-created library and referenced 
globally (.GLOBL pseudo-op). If they are to be incorporated directly 
into a program, the .GLOBL and .END pseudo-ops must be removed. 

Unpacking Routine 

This routine has two entry points, GT.FST and GT.CHR. The GT.FST 
entry is used to initialize the routine for each unpacking sequence. 
Upon entry via GT.FST, the AC must contain the address of the first 
location in the buffer. (The routine automatically skips over the 
Header Word Pair.) On return the AC is unchanged. After initiali- 
zation, each entry via GT.CHR returns a 7-bit ASCII character right 
justified in the AC. The user program must detect the end of the 
logical record, normally by checking for a Carriage RETURN or ALT MODE 
terminator. Entry to the routine from the user program is made by 
either a JMS or a JMS* instruction as follows: 

If this routine is directly incorporated in the user's 
program: 

LAC ADDRESS /BUFFER ADDRESS 

JMS GT.FST /ENTRY TO INITIALIZE UNPACKING 

JMS GT.CHR /ENTRY TO UNPACK A CHARACTER 

If this routine resides in a library: 

.GLOBL GT. FST, GT. CHR/EXTERNAL GLOBL DECLARATION 

LAC ADDRESS /BUFFER ADDRESS 

JMS* GT.FST /ENTRY TO INITIALIZE UNPACKING 

JMS* GT.CHR /ENTRY TO UNPACK A CHARACTER 

DAC SAVCHR /SAVE CHARACTER RETURNED IN AC 
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Packing Routine 

This routine also has two entry points, PK.FST and PK.CHR. The 
PK.FST entry is used to initialize the routine for each new packing 
sequence. Upon entry via PK.FST, the AC must contain the address of 
the first location in the buffer (the routine ignores the header word 
pair automatically) ; on return, the AC is unchanged. After initializa- 
tion, each entry via PK.CHR with a character in the AC will pack that 
character in 5/7 format. The characters to be packed must be right 
justified in the AC. On return to the user, the AC will still con- 
tain that character, however, bits 0-10 of the AC will be set to zero. 
The user program must detect the end of the logical record, normally 
by testing for a terminator such as Carriage RETURN or ALT MODE. 
Further, the user must also set up the header word pair for the 
logical record. Entry to the packing routine is made from the user's 
program either by a JMS or JMS* instruction as follows: 

If this routine is directly incorporated in the user's 
program: 

LAC ADDRESS /BUFFER ADDRESS 

JMS PK.FST /ENTRY TO INITIALIZE PACKING 


LAC CHAR /CHARACTER TO BE PACKED 

JMS PK.CHR /ENTRY TO PACK A CHARACTER 

If this routine resides in a library: 

. GLOBL PK.FST, PK.CHR /EXTERNAL GLOBL DEFINITION 


LAC ADDRESS /BUFFER ADDRESS 

JMS* PK.FST /ENTRY TO INITIALIZE PACKING 


LAC CHAR /CHARACTER TO BE PACKED 

JMS* PK.CHR /ENTRY TO PACK A CHARACTER 
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sen l 

N PACKING S 

UBEOUTINE 

/ G T v F S T 

-• I N 1 T 3 

ALIZE 5/7 

* A 5 C 1 1 U N P A C K I N G * 0 N E N T R Y 

/AC CON 

TAINS 

ADDRESS OF 

I/O BUFFER TO BE 

/UNPACK 

ED* ON 

E E T U E N A C 

IS RESTORED * 

/ Q 7 .j, Q j •: P 

••••AFTER 

S/7 v-ASCI 

I UNPACKING HAS BEEN 

/INI 11 A 

1... I ZED 

B Y GT * FST * 

GT * CHE WILL RETURN 

/SUBS EG! 

CENT L 

HAEACTEES 

IN AC* 


. nr 

i 

GT * CHE 

GT * FST 

Q 


/INITIALIZE 


DAC 

GT * THE 

/SAME AC 


TAD 

L2 

/SET BUFFER POINTER 


DAC 

GT . PTE 

/TO SKIP OMEE HEADER WORD PAIR 


LAW 

•••• :L 

/ C H A E A C T E E C 0 U N T E E 


DAC 

GT * 5 



LAC 

j M i::» \is 

GT * TMP 

/RESTORE AC 

GT •> CHR 

A 




,JMP 

GT ♦ MO 

/ W 0 E D P A I E S T A E T E D 


LAC* 


/NEED NEXT PAIR 


DAC 

GT* WD :L 

/!•• IPs i Pair 


1... A C * 

GT * PTE 



ISZ 

GT * PTE 



DAC 

GT * WD2 

/SECOND PART 


LAW 

t */ *7 7 3 

/ E E S E T C H A E A C T E R C 0 U N T E R * 


DAC 

GT * 5 


GT . MO 

LAW 

17770 

/SHIFT LOOP TO 7 1/2 TIMES 


DAC 

GT * WD3 


GT , LUP 

LAC 

GT * WD2 



RAL 




ISZ 

GT * WD3 



JMP 

GT * MOP 



AND 

LI 77 

/ G 0 T C H A E A C T E R 


SAD 

S p A C E 

/ 1 F S P A C E D 0 N T U P D A T E G T * i... S T 


JMP 

GT * EXT 


GT * EXT 

JMP* 

GT ♦ CHE 

/EXIT 

GT ♦ HOE 

DAC 

GT * WD2 



LAC 

GT * WD 1 



EAL 




DAC 

GT ♦ WD 1 



JMP 

GT * LUP 

/BACK TO LOOP 

/ 




GT , PTE 

o 



G T > 5 

o 



GT»UD1 

0 



GT.WD2 

0 



GT , UD3 

o 



GT . Trip 

0 



L2 




LI 77 

1 77 



SPACE 

40 




* END 
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/ 1 0 P S < 5 / 7 > P A C K I N G S U B R 0 U T I N E 


/PK.FST - IN I 7 

XALIZE 5 /S 

, A S C 1 1 U N P A C K I N G * 0 N E N T R Y 

/ A C C 0 N T A I N S A D D R E S S 0 

I/O BUFFER TO CONTAIN PACKED ASCI I ? 

/ON RETURN AC 

IS UNCHANG 

ED. 

/PK . CHR IS NOF 

MAL ENTRY 

P 0 1 N T A F T E R I N I T I A L I Z A T 1 0 N ( P K . F S T ) 

/AC CONTAINS C 

HA RAC TER TO BE PACKED * ON RETURN ? AC CONTAINS 

/THE SAME CHAF 

AC TER BUT 

HIGH ORDER BITS (0-10) ARE ZEROED 

/OUT , 



, GLOBE 

PK . FST s- F 

K , CHR' 

SH A L --660000 



PK.FST 0 


/INITIALIZE 

DAC 

KLCFIR2 

/SAVE AC 

TAD 

1.2 

/SET KLPUTP TO BUFFER ADDRESS+2 

DAC 

KLPUTP 

/ i 0 S K I F‘ 0 v L k FI fc. A D E F-! W {.J R D !••' A .1. R 

DZM 

KL57 


DZM 

CHRCNT 


LAC 

KLCHR2 

/RESTORE AC 

JMP* 

PK ♦ FST 

/EXIT 

PK.CHR 0 



AND 

LHKLN i 


DAC 

KLCHR2 


L- L. I... 

LAC 

KL57 

/CHAR * POSITION. 

TAD 

< JM P# 

1 \ «... w / 

DAC 

V ‘l‘Z 


LAC 

KLCHR2 


XX 


/MODIFIED JMP 

KLJ57 KL..S71 


/CHARI 

K L / a*:! 


/ CFi AK ‘2 

K ] 5 7 3 


/ C H ft R 3 

l\ I... 3 / 4 


/ L- H R K -Y 

/ L H ft K b 

K !... 5 7 1 A L. S ! S F 

Ai... 

13 /II LEFT 

KL57 1 A DZM# 

KLPU'f P 

/ C L E A R D A T A W 0 R D 

JMP 

K ENDS 7 


KL572 ALS ! SF 

f) L. 

4 / 4 LEFT 

JMP 

KLND57 


K L. 573 RTF: 


. 3 RIGHT--! ST HALF 

RAR 



AND 

i... J. 7 


X U K W- 

j / | ^ j ”f‘ |m ! 


DAC# 

KLF'U TP 


ISZ 

KLPUTP 

/LAS I WORD OF F’AIR ♦ 

!... A U 

&\ Si q?.. 

KLCFIR2 

/2ND HALF' 

•i -i i s::- r 

JMP 

KL571A 


KI...574 ALS- ! SF 

AL 

1.0 / 8 LEFT 

j jvj p 

KLND57 


KL575 RCi... 


/ J. i.. F. i- ] 

DZM 


/ p j:z c p* T / “7 h f \ j j j\{ t p 
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KLND57 


!\ L. D / 

KLPUTP 

KLCHR2 

C'MRCNT 


Sample 

IOPS ASCII 

ISZ 

KL.57 

XOR# 

\LPUTP 

DAC# 
L A C 

\LPUTP 

SNA 

<LPUTP /2N 

LAC 

\LCHR2 

JHP& 

K <• C I"! R / E X 



* END 
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INPUT/OUTPUT DATA MODE TERMINATORS 


All handlers determine the data mode from the .READ or .WRITE macro 
as shown in the following table. Abbreviations and acronyms are defined 
at the end of the table. 
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Input/Output Data Mode Terminators 
























SPECIFIC DEVICE HANDLERS (Cont) 


DATA MODE 

HANDLER 

INPUT 

OUTPUT 

IMAGE ALPHA/ 
IMAGE BINARY 

DT 

Call versions) 

whichever is smaller 
EOM, EOF ; 

HWP , EOM 


DK, DP , RK 
Call versions) 

whichever is smaller 

EOM , EOF 

HWP , EOM 

CDB. 

Not applicable 

Not applicable 

LPA.15 

LPA.ll 

Not applicable 

Not applicable for BIN 
HWP, CR, AM, VC for ALPHA 

IOPS 37 if line is exceeded 

MTA. 

^ ^ ^ whichever is smaller 

EOM , EOF 

HWP , EOM 

MTC. 

whichever is smaller 

EOM, EOF 

HWP, EOM 


MTF . 

WC, EOM, EOF 

HWP, EOM 


TTA . 

Not applicable for BIN 
CTRL D, WC for ALPHA 

Not applicable for BIN 
HWP 


PP 

Call versions) 

Not applicable 

HWP, EOM for BIN 

HWP, AM, CR, EOM for ALPHA 

PR 

Call versions) 

WC , EOM , EOF 

Not applicable 


Input/Output Data Mode Terminators 


























SPECIFIC DEVICE HANDLERS (Cont) 


DATA MODE 

HANDLER 

INPUT 

TOPS Binary 

DT 

Call versions) 

HWP, WC whichever is smaller 

EOM, EOF 

DK, DP, RK 
(all versions) 

HWP, WC whichever is smaller 

EOM, EOF 

CDB. 

Not applicable 

LPA.15, LPA.ll 

Not applicable 

MTA. 

HWP, WC whichever is smaller 

EOM , EOF 

MTC . 

HWP, WC whichever is smaller 

EOM, EOF 

MTF . 

WC, EOM, EOF 

TTA. 

Not applicable 

PP 

Call versions) 

Not applicable 

PR 

(all versions) 

WC, EOM, EOF 


XYA 


NA 


OUTPUT 


1 

HWP , EOM 

HWP, EOM 

Not applicable 

Not applicable 
HWP , EOM 

HWP, EOM 

HWP, EOM 

Not applicable 

HWP, EOM 

Not applicable 
DD 


























DATA MODE 


HANDLER 


INPUT 


OUTPUT 


DUMP MODE 


1 


DT 

(all versions) 

WC, EOM , EOF 

WC, EOM 

DK, DP, RK 
(all versions) 

WC, EOM, EOF 

WC , EOM 

CDB . 

Not applicable 

Not applicable 

LPA.15, LPA.ll 

Not applicable 

Not applicable 

MTA . 

WC, EOM, EOF 

WC, EOM 

MTC. 

Not applicable 

Not applicable 

MTF . 

Not applicable 

Not applicable 

TTA. 

Not applicable 

Not applicable 

PP 

Not applicable 

WC , EOM 

PR 

WC , EOM 

Not applicable 


List of Abbreviations and Acronyms: 
Handlers : 


Abbreviations : 


DT 

DECtape 


DK, DP, RK 

Disk (DECdisk or Disk Pack or 

Disk 


cartridge) 


CDB. 

Card Reader Handler 


LPA. 15 

Line Printer Handler for XVM 

users 

LPA. 11 

Line Printer Handler for UC15 

users 

MTA. 

Magtape "A" Handler 


MTC. 

Magtape "C" Handler 


MTF. 

Magtape "F" Handler 


TTA 

Teleprinter Handler 


PP 

Paper Tape Punch Handler 


PR 

Paper Tape Reader Handler 



AM 

ALT MODE key 


CR 

Carriage RETURN 

(RETURN) key 

EOF 

End -of -File 


EOM 

End-of -Medium 


HWP 

Header Word Pair 

1 s word pair count 

VC 

Vertical Control 

Character 

WC 

Word Count in an 

I/O Macro 

DD 

Data dependent 





















APPENDIX D 


IOPS ERROR CODES 

The following table lists the Meaning and Data Output for those IOPS 
error codes that are unrelated to UNICHANNEL operation. The UNICHAN- 
NEL IOPS error codes (IOPSUC) are described in Appendix J. 


D— 1 



MEANING FOR IOPS ERROR CODES 


Error Code 

Meaning 

Error Data Output 1 

0 

Illegal CAL Function Code - The function code immedi- 
ately following the offending CAL instruction is not 
legal 

CAL address 

1 

CAL* Illegal - The Monitor does not permit execution 
of CAL* (indirect) instructions 

CAL address 

2 

.DAT Slot. Error - 

a. The .DAT Slot number (bits 9-17 of the CAL) 
is either 0 or outside the range of legal 
numbers established when the system was 
created (at System Generation) . 

b. No . IODEV has been issued for this .DAT Slot. 

CAL address 

3 

Illegal Interrupt -An interrupt originated from a de- 
vice when either its handler was not core resident or 
its handler was not previously initiali zed (via .INIT). 

Contents of the IORS word at 
the time of the interrupt.! 

4 

Device Not Ready - 

a. Device“ 7r OFF LINE", "WRITE PROTECTED" or Unit 
Number not selected. 

b. Line Printer or Paper Tape Punch out of paper. 

c. Line Printer Alarm Status 

d. Card Reader stacker full, mis-punched card, 
card jam, hopper empty, EOF card missing. 

e. 9-channel I/O request to 7-channel Magtape 
transport (or vice versa) . 

Remedy error condition and type CTRL R to continue 
interrupted operation. 

Disk - dv & unit, CAL fcn,UIC 

Card Reader - dv, message 

Line Printer - dv 

Teleprinter - dv 

Magtape - dv, & unit, CAL fen 

DECtape - dv & unit 

Other - CAL adr 

5 

Illeqal Setup CAL - A CAL to set up API/PI linkage was 
issued by a handler (as a result of a .INIT) when no 
skip TOT existed in the Monitor's Skip Chain for that 
device (IOTs are placed in the Skip Chain during System 
Generation. ) . 

CAL address 
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MEANING FOR IOPS ERROR CODES (Cont) 


Error Code 

Meaning 

Error Data Output 1 

6 

Illegal Handler Function - A CAL has been issued 
to a handler which is incapable of performing 
that function (e.g. , .READ to the paper tape 
reader , .TRAN to the disk in the reverse direc- 
tion, etc. } 

Disk - CAL adr ,dv & unit, CAL fcn,UIC 
Card Reader - dv, message 
Line Printer - dv 
Teleprinter - dv 

Magtape - CAL adr,dv & unit, CAL fen 
Other devices - CAL address 

7 

Illegal Data Mode - 

a. A .READ or .WRITE was issued using a 
Data Mode unacceptable to the handler. 

b. An attempt was made to change transfer 
direction prior to issuing a new . INIT 
via that .DAT Slot. 

c. For DL11 - attempt to change from 
non-file oriented to file oriented 
I/O. 

Disk - CAL adr , dv & unit, CAL Fen, UIC 
Card Reader -dv, message 
Line Printer - dv 
Teleprinter - dv 

Magtape - CAL adr,dv & unit, CAL fen 
Other devices - CAL address 
DL11 - CAL adr, dv 

10 

File Still Active - Failure to close (.CLOSE) a 

Disk - CAL adr ,dv & unit, CAL fen, UIC, 
f ilnam 

Magtape - CAL adr,dv & unit, CAL fen 
DECtape - CAL adr 

file before another .SEEK, .ENTER, .RAND, .RENAM, 
.FSTAT, . DLETE or .CLEAR is issued via the same 
.DAT Slot. 

11 

.SEEK/ .ENTER/. RAND Not Executed - 

A .READ, .WRITE, or . RTRAN was issued to a direc- 
toried device vith no prior . SEEK/ . ENTER/ . RAND . 

Disk - CAL adr , dv & unit, CAL fen, UIC 
Magtape - CAL adr,dv & unit, CAL fen 
DECtape - CAL adr 

12 

Terminal Device Error - 

DECtape - The contents of device 
status register "B" (bits 0-11) and 
unit no. (bits 15-17) 

Magtape -CAL adr, dev & unit, CAL fen 

a. DECtape mark track error (tape must be 
reformatted) 

b. Magtape EOT encountered on space forward 

13 

File Not Found - The file name specified in the 

Disk - CAL adr , dv & unit, CAL fen, UIC, 
f ilnam 

Magtape - CAL adr 
DECtape - CAL adr 

CAL argument (CAL+2) is not in the file directory 
of the device associated with the specified .DAT 
Slot (.SEEK, .ENTER, .RAND ). 

14 

Directory Full - In response to a .ENTER the DEC- 
tape or MAGtape handler has determined that there 
is no space for another file name. 

Magtape - CAL adr 
DECtape - CAL adr 
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MEANING FOR IOPS ERROR CODES (Cont) 


Error Code 

Meaning Error Data Output 

15 

Device Full - No space available on the device medium 
for data storage. 

Disk - CAL adr, dv & unit, CAL ten, UlC, 
Magtape - CAL adr,dv, & unit, CAL fen 
DECtape - CAL adr 

16 

Output Buffer Overflow - The word pair count on the 
current .WRITE is greater than 177 g . (This error 
is obsolete and has been replaced by IOPS 23.) 

CAL adr 

17 

Too many Files for Handler - Too many files are cur- 
rently open on the handler to be referenced by this 
CAL. (See handler descriptions in Chapter 9 for 
limitations. 

Disk - CAL adr,dv & unit, CAL fen, UIC 
Magtape - CAL adr,dv & unit, CAL fen 
DECtape - CAL adr 

20 

Disk Hardware Failure - 

Block no., dv & unit, CAL fen, UIC 

21 

Illegal Disk Address - An attempt was made to refer- 
ence a block number which was either 0 or greater 
than the maximum number of blocks available on the 
disk. 

Block no., dv & unit, CAL fen, UIC 

22 

Two Output Files on One Unit - An attempt was made 
to reference more than one output file concurrently 
on the same DECtape or Magtape unit. 

Magtape - CAL adr,dv & unit, CAL fen 
DECtape - CAL address 

23 

Illegal Word Pair Count - The word pair count in 
header word 0 of the logical record currently being 
transferred is either 0 or greater than 177g. For 
DLl 1 , this error is given when an attempt is made 
to transmit more than 73g characters. 

Disk - CAL adr, dv & unit, CAL fen, UIC 
filnam 

Magtape - CAL adr,dv & unit, CAL fen 
Other devices - CAL adr. 

DLl 1 - CAL ab, dv. 

24 

Illegal unit number. 

Card Reader - CAL adr 
DL11 - CAL adr, dv 

25 

Negative or 0 character count (IOPS ASCII write) 

X or Y increment too large (>2**14) (binary write) 

XY Plotter - CAL address 

27 

Illegal write type. 

XY Plotter - CAL address 

30 

API Software Level Error - An API break occurred to 
a software API level which did not have the appropri- 
ate transfer vector (s) setup in . SCOM+12 through 
. SCOM+15 • 

Contents of the API Status Register 

31 

Nonexistent Memory Reference - A nonexistent memory 
reference occurred with memory protect mode ON 
without a user-defined violation routine. 

Program Counter 
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MEANING FOR IOPS ERROR CODES (Cont) 


Error Code 

Meaning 

Error Data Output 1 

32 

Memory- Protect Violation - A reference was made to 

Program Counter 

a location in memory below the memory protect 
boundary without a user— defined violation routine. 

33 

Memory Parity Error - A memory parity error occurred 

Program Counter 

without a user-defined error routine. 

34 

Power Fail Skip Not Setup - The power failure inter- 

Program Counter 

rupt detected a power low condition with no user- 
defined service routine to save appropriate registers 

35 

Control character routine returned to IOPS error 
processor . 

Control Character routine address 

37 

Print Line Overflow - The 81st or 133rd character 
(depending on the line printer type) of the line 
currently being output is not a legal terminator. 
(Carriage RETURN , ALT MODE , FORM FEED , LINE FEED , Ver- 
tical TAB, etc.). The rest of the line is lost. 

CAL adr , dv 

40 

Header Label Error - During processing of a .SEEK 
to a Magtape file, the handler calculated file 
name disagrees with name present in file header 
label . 

CAL adr 

41 

Directory Format Error - Illegal or meaningless data 
was found in the Magtape file directory. 

CAL adr 

42 

Accessibility Map Overflow - During the processing 
of an .ENTER to the Magtape unit, the accessibility 
map is found to be full. (Too many files.) Use 

MTDUMP to delete unwanted files to obtain space. 

CAL adr 

43 

Directory Recording Error - The file directory of 
the referenced Magtape has been contaminated. 

Use MTDUMP to reformat the directory. 

CAL adr 
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MEANING FOR IOPS ERROR CODES (Cont) 


Error Code 

Meaning 

Error Data Output 1 

44 

Logical EOT Detected - The Magtape handler detected 
a logical End— of-Tape during the processing of a 
.SEEK or .ENTER. 

CAL adr,dv & unit, CAL fen 

45 

Long Input Record - The record being incut from Macr- 
tape is too long for the handler's internal buffer 
(255j~ words maximum) . 

CAL adr,dv & unit, CAL fen 

46 

Attempt to Delete A System File - An attempt has 
been made via a .DLETE to delete a file having a 
"SYS" extension (applies to Advanced Monitor System 
DECtapes only) . 

CAL address 

4 7 

Illegal Horizontal Tab - An attempt has been made to 
issue a Horizontal TAB operation on the Line Printer 
which caused the column count to exceed the device's 
capacity for line length. 

CAL adr,dv 

51 

Illegal User File Directory - When performing Disk 

CAL adr,dv & unit, CAL fen, UIC 

I/O: 

a. A .USER was issued using -1, ??? , or @@@ as 
a UIC. 

b. A .SEEK was attempted to a nonexistent UFD. 

55 

No Buffers Available - A . GTBUF Macro was issued from 

CAL adr ,dv & unit, CAL fen, UIC 

either a handler or a user program with an insuffi- 
cient number of buffers allocated (see BUFFS for 
DL11, no TCB area available. 

56 

Mass Storage Busy Table Full - An attempt to open a 

CAL adr,dv & unit, CAL fen 

file on a handler which uses the MSBT when there 
was not an empty entry in the MSBT. This can occur 
only when the user is making dynamic .DAT 
assignments . 

61 

Parity Error in Directory or File Bit Map - Defective 

Disk - CAL adr ,dv & unit, CAL fen, UIC 
DECtape - CAL address 

data, device medium, or hardware (see Recovery pro- 
cedure for DECtape in note 2 below) . 

63 

Protected User File Directory - Attempt to create 

CAL adr,dv & unit, CAL fen, UIC 

(.ENTER) or delete (.DLETE) a file in a protected 
directory (see 9.3.5). 
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MEANING FOR IOPS ERROR CODES (Cont) 


Error Code 

Meaning 

Error Data Output 1 

64 

Protected File - Attempt to access a file via 
.RAND with protection codes 2 or 3, or to .SEEK 
a disk file with protection code of 3. 

CAL adr,dv & unit, CAL fen, UIC 

65 

Unrecoverable Maatape Error - 

For DLll - Unrecoverable Telecommunications Error 

Magtape status word, dv, CAL, fen 
DLll - status word, dv 

66 

Relative Block Not Within File — Attempt to access 
(.via . RTRAN ). a block not within the limits of the 
current file [i.e., block 0 or n+1] ) . 

CAL adr , dv & unit, CAL f cn ,UIC , f ilnam 

67 

Illeqal DECdisk Word Transfer Starting Address or 
Count - When issuincr an .RTRAN: 

a. The argument which specifies the first word 
in the DECdisk block to be transferred is 
either 0 or greater than 376 Q . 

O 

b. The argument which specifies the number of 

words to be transferred exceeds the physical 
block size (i.e. , 0<no. words< 253-word 

starting address) . 

I/O buffer above 32K. 

CAL adr , dv & unit, CAL f cn , UIC , f ilnam 
DLll - CAL adr, dv 

70 

Size Too Small - The size of -t-he hnffo r alln 



CAL adr , dv & unit, CAL fen, UIC 

cated by . GTBUF and . GVBUF Macros (established during 
ys tern Generation) is not large enough for the handler 
attempting to utilize them. 

71 

Empty UFD - a .SEEK or .RAND was attempted to a UFD 
which did not contain any files. 

CAL adr ,dv & unit, CAL f cn , UIC , f ilnam 

mm 

Input Parity or Write Check Error - Hardware error- 

block no. ,dv & unit, CAL fen, UIC 

detected; type CTRL R to continue. 

73 

Null File Name - A . SEEK , .RNTRR f , PLETE , FSTAT nr 

CAL adr ,dv & unit, CAL fen, UIC 

.rand was issued with a null filename argument. 
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MEANING FOR IOPS ERROR CODES (Cont) 


Error Code 

Meaning 

Error Data Output 1 

74 

Disk System File Structure Degradation 3 - 

a. Attempt to turn off a bit in a submap 
that is already off. 

b. Attempt to write block 0 in a sequential 
f ile. 

c. Attempt to use block ^ as a UFD block. 

d. Nonexistent submap. 

CAL adr ,dv & unit, CAL fen, UIC,filnam 

7 S 

Disk System File Structure Degradation - 
Word 1 of submap is greater than word 0 or 
is 0 or negative. 

CAL adr,dv & unit, CAL f cn ,UIC , f ilnam 

16 

Disk System File Structure Degradation - 
Word 376 8 of the first UFD or MFD block is 
not -1. b Type CTRL R to continue. 

CAL adr , dv & unit, CAL f cn ,UIC , f ilnam 

77 

Undersized or Nonexistent CTRL Q AREA - The 
system attempted to utilize a CTRL Q area 
(via CTRL Q, QDUMP , GET, PUT, GETP , GETT, 

GETS keyboard commands) which was nonexistent 
or of insufficient size for the amount of core 
available. (The CTRL Q area is created 

during System Generation. ) 

The address (15-bits) to which control 
would have been passed if the requested 
operation had been successful. 


NOTES 

i Abbreviations : addr — address dv = device fen — function filnain — file name 

1 Recovery procedures for IOPS 61 : 

1) Repeat operation which causes error. 

2) If error persists, remount DECtape on another drive and repeat step 1. 

3) If error still persists and you are very familiar with DECtape file structure and have a reasonably current directory 

listing, proceed as follows: 

a. Using DUMP, obtain a listing of each file in the directory listing. (The directory listing provides the start- 
ing block number for each file. The last (link) word in each block points to the next block. Negative block 

numbers indicate reverse recording. Last block has a link of 777777.) 

b. Use PIP to block copy each file onto a good tape. 

c. Use PATCH to construct a directory on the new tape. IX) NOT WRITE ON THIS TAPE - IT HAS NO BIT MAPS. 

d. Use PIP to transfer each reconstructed file to still another tape (this reconstructs the master and file bit maps). 
3 These errors usually result from hardware failure or inadvertent manipulation of disk structure data areas. 
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APPENDIX E 

LINKING LOADER AND SYSTEM LOADER ERRORS 


The following error codes are output by both the Linking Loader and 
the System Loader. When output by the Linking Loader, the errors are 
identified as shown below. When output by the System Loader, the 
errors are identified as " . SYSLD n" instead of ".LOAD n" . 


Error 


•LOAD 1 


.LOAD 2 


•load 3 


.LOAD 4 


.LOAD 5 


Memory overflow - the Loader's symbol table 
and the user's program have overlapped. At 
this point the Loader memory map will show 
the addresses of all programs loaded suc- 
cessfully before the overflow. Increased 
use of COMMON storage may allow the pro- 
gram to be loaded, as COMMON can overlay the 
Loader and its symbol table, since it is 
not loaded into until run time. 

Input data error - parity error, checksum 
error , illegal data code, or buffer over- 
flow (input line bigger than Loader's 
buffer) . 

Unresolved Globals - any programs or sub- 
routines required but not found, whether 
called explicitly or implicitly, are 
indicated in the memory map with an ad- 
dress of 000000. If any of the entries in 
the memory map has a 000000 address, 
loading was not successful; the cause of 
trouble should be remedied and the pro- 
cedure repeated. 

Illegal .DAT slot request - the .DAT slot 
requested was: ~ 

a. Out of range of legal .DAT slot 
numbers , 

b. Zero, 

c. Unassigned; that is, was not set 
up at System Generation Time or 

was not set up by an ASSIGN command. 

s egment greater than 4K — the program 
segment being loaded in Page Mode exceeds a 
Page Bound (i.e., program is greater than 4K) . 
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Linking Loader and System Loader Errors 


COMMON block length error 


.LOAD 6 


.LOAD 7 


.LOAD 8 


.LOAD 9 
device 


a. Common Block Too Large - An attempt was 
made to allocate a common block of zero 
length or larger than 32K-1 words. A 
loader map line of the form: 

C blknam length 

will be output on the console printer 
immediately prior to the line containing 
the error code. The program which made 
the offending common block reference 
will be the most recent program name 
typed out via the "P" (program load 
address) loader map option. 

b. COMMON block requested length is greater 
than its lerxgth when first loaded. This 
error may be the result of loading the 
modules in the wrong order. It is 
remedied by defining all instances of 
the same COMMON block to be of identical 
length. 

Value of Relocated Global Symbol Too 
Large - An attempt was made to define 
a global symbol with a relocated value 
greater than 32K-1. A loader map line 
of the form: 

G symnam value 
where : 

symnam = global symbol name 

value = attempted value 

will be output on the console printer 
immediately prior to the line containing 
the error code. 

Data initialization attempt outside of 
range of program or COMMON block. This 
can be the result of an input data error 
but is usually caused by an illegal data 
initialization attempt via the MACRO 
.CBC pseudo-op. 

Duplicate handler request - More than 
one handler for the same device has 
been requested. The first two letters 
of the duplicate file names are output 
along with the error message. Loading 
continues despite this message but when 
the loaded programs are executed, in- 
terrupts initiated by I/O requests may 
not properly distinguish among the 
multiple handlers causing an error. 
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APPENDIX F 


XVM ASCII/HOLLERITH CORRESPONDENCE 

The following table shows the correspondence between the XVM 64 
character graphic subset of ASCII and the DEC 029/026 Hollerith codes. 
Both 029 and 026 codes are identical for numeric and alphabetic 
characters but vary for symbol representation. The 029 code, except 
as indicated by brackets , is a subset of the standard Hollerith 
punched card code specified in ANSI standard X3. 26-1970. Characters 
in parentheses denote the 1963 character set. 
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XVM ASCII/Hollerith Correspondence 


| ' ASCII 

HOLLERITH 

-ASCII 

HOLLERITH j 


7-BIT 

DEC 029 

DEC 026 


7-BIT 

DEC 029 

DEC 026 

CHAR. 

CODE 

CODE 

CODE 

CODE 

CODE 

CODE 

Space 

40 



§ 

100 

8-4 

8-4 

i 

41 

[11-8-2] 

12-8-7 

A 

101 

12-1 

12-1 

fl 

42 

8“7 

0-8-5 

B 

102 

12-2 

12-2 

# 

43 

8-3 

UD 

CO 

1 

o 

C 

103 

12-3 

12-3 

$ 

44 

11-8-3 

11-8-3 

D 

104 

12-4 

12-4 

% 

45 

0-8-4 

0-8-7 

E 

105 

12-5 

12-5 

& 

46 

12 

11-8-7 

F 

106 

12-6 

12-6 

1 

47 

8-5 

8-6 

G 

107 

12-7 

12-7 

( 

50 

12-8-5 

0-8-4 

H 

110 

12-8 

12-8 

) 

51 

11-8-5 

12-8-4 

I 

111 

12-9 

12-9 

* 

52 

11-8-4 

11-8-4 

J 

112 

11-1 

11-1 

+ 

53 

12-8-6 

12 

K 

113 

11-2 

11-2 

1 

54 

0-8-3 

0 

1 

00 

1 

00 

L 

114 

11-3 

11-3 

- 

55 

11 

11 

M 

115 

11-4 

11-4 

# 

56 

12-8-3 

12-8-3 

N 

116 

11-5 

11-5 

/ 

57 

0-1 

0-1 

0 

117 

11-6 

11-6 

0 

60 

0 

0 

P 

120 

11-7 

11-7 

1 

61 

1 

1 

Q 

121 

11-8 

11-8 

2 

62 

2 

2 

R 

122 

11-9 

11-9 

3 

63 

3 

3 

S 

123 

0-2 

0-2 

4 

64 

4 

4 

T 

124 

0-3 

0-3 

5 

65 

5 

5 

U 

125 

0-4 

0-4 

6 

66 

6 

6 

V 

126 

0-5 

0-5 

7 

67 

7 

7 

w 

127 

0-6 

0-6 

8 

70 

8 

8 

X 

130 

0-7 

0-7 

9 

71 

9 

9 

Y 

131 

0-8 

0-8 

: 

72 

8-2 

11-8-2 

Z 

132 

0-9 

0-9 

t 

73 

11-8-6 

0-8-2 

[ 

133 

12-8-2 

11-8-5 

< 

74 

12-8-4 

12-8-6 

\ 

134 

11-8-7 

8-7 

= 

75 

8-6 

8-3 

] 

135 

0-8-2 

12-8-5 

> 

76 

0-8-6 

11-8-6 

" ( + ) 

136 

12-8-7 

8-5 

? 

77 

0-8-7 

12-8-2 

-\ w 

137 

0-8-5 

8-2 

■— 


NOTES: 1. ASCII codes 00-37 and 140-177 have no corresponding codes in 
the DEC 026 & 029 Hollerith sets and therefore, are not pre- 


sented here. 

2. ALT MODE is simulated by a 12-8-1 punch (multiple punch A8) . 

3. End-of-file corresponds to a 12-11-0-1 punch (multiple punch 
AJ0-1. 

4. The card reader hardware supplies the binary equivalent of 
Hollerith code which in turn is mapped into 7-bit ASCII by 
the Card Reader Handler. 
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APPENDIX G 


SPECIAL DEBUGGING TOOLS 
(QDMP XVM and UDMPll) 

Two special dump tapes are being issued with the XVM/DOS system. These 
tapes, which use hardware read in mode (HRM) , are very special purpose 
dumps, and are provided as a convenience to those customers with the 
exact configurations needed for their use. These are unsupported 
items. No commitment to improve these products or to make them more 
applicable to general usage is implied. 

QDMP XVM 


This paper tape performs a +Q dump of XVM memory to DECtape . It over- 
lays most of the XVM/DOS bootstrap. The standard XVM/DOS DUMP program 
can be used to print the data after the system has been recovered. 

Operating Instructions 


1. Load the QDMP XVM paper tape into the reader. 

2. Load 77650g (32K) into the ADDRESS Switches. 

57650 g (24K) 

3. Set the console data switches to zero to signal QDMP XVM to 
dump core up to and including itself. If the data switches 
are set non-zero, QDMP XVM will use that as the upper limit 
of memory (up to 17 bits of address may be specified) . 

4. Put an empty directoried DECtape on DECtape unit #7 WRITE 
enabled. The tape need not be initialized with space reserved 
for a QDMP. If such is not done, however, subsequent writing 
of user files to the tape may destroy the dumped data. 

5. Depress STOP and RESET simultaneously. 

6. Depress READIN. 

7. The Dump should now occur. If it does not occur, a problem 
such as DECtape offline, etc., has been detected. Rectify 
the problem and press CONTINUE. 

8. Reload XVM/DOS. 

9. Use the ALL command (to the DUMP program) to list the dump 
from DECtape #7. The amount of core listed by DUMP is a func- 
tion of the amount of core in use when DUMP is loaded. 
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Special Debugging Tools 
(QDMP XVM and UDMP11) 


UDMP11 


This program performs a dump of the PDP-11 local memory to the PDP-11 
listing device (LP11/LS11/LV11) . It loads into common memory. All 
registers except the PC, PS, and device registers are listed. 

Operation : 

1. Load the UDMP11 paper tape into the Reader. 

2. Halt the PDP-11. 

3. Load the XVM address switches with 11100 g . 

4. Depress STOP and RESET on the XVM console. 

5. Depress READIN on the XVM console. 

6. The tape should now read in. If it fails to read in, repeat 
steps 3, 4 and 5. 

7. Load 100000 for 8K or 120000 for 12K, the starting address, into 
the PDP-11 switch register. 

8. Raise the PDP-11 HALT switch. 

9. Insure that the listing device is ON-LINE. 

10. Depress the PDP-11 START switch. The Dump should now proceed. 
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APPENDIX H 

XVM/DOS TERMS AND ACRONYMS 


Terms unique to the XVM/DOS Software System are listed and described 
in the following table. The acronyms for each term are also given. 


TERM 

ACRONYM 

DEF IN IT ION 

Bad Allocation Table 

BAT 

A device (disk) table which in- 
dicates, in storage blocks, any 
faulty disk areas in which data 
cannot be stored. 

Master File Directory 

MFD 

A master device (disk) file di- 
rectory which contains pointers 
to all user directories (UFD's) 
within a disk device. 

Monitor Identification Code 

MIC 

The master system password which 
permits full access to all files 
within the system. This code 
identifies the system manager 
and should be used only by him. 

Storage Allocation Table 

SAT 

The device (disk) table which 
stores busy, not-busy indicators 
for the disk storage area. 

System Block 

SYSBLK 

The system table which contains 
the names, locations, and loading 
and starting parameters for all 
system programs within the oper- 
ating system. 

User File Directory 

UFD 

File directories for each user who 
established disk file storage 
areas within the system. 

User File Directory Table 

UFDT 

The system directory table which 
maintains the relationship between 
the system's .DAT slots and each 
unique user identification code 
(UIC) . 

User Identification Code 

UIC 

A password entered by a user to 
uniquely- define himself and any 
files which he may enter. If 
necessary, a user may enter more 
than one UIC to establish several 
unique sets of files. Since only 
one user may employ the system at 
any one time, the current UIC is 
the last logged-in UIC. 
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APPENDIX I 

UC15 SPOOLER ERROR MESSAGES 

The following is a list of the error messages printed by the 'SPOOL' 
program and the conditions that cause these: 

MESSAGE CONDITIONS 

("$" BAD HERE) An altmode is not allowed as the 


.DAT -14 SYSTEM FAILURE - ABORT 
(# > 6 DIGITS) 

DISK BUFFER - NOT IN COMMON 
MEMORY - ABORT 


FATAL ERROR - DOS LACKS TCB 
AREA FOR SPOL15 USE - ABORT 

FATAL RK DISK ERROR - ABORT 


FATAL TCB ERROR ON SOFTWARE 
DIRECTIVE - ABORT 

("n" HAS NO SPOOLER AREA) 

INSUFFICIENT FREE LOCAL- 11 
MEMORY TO LOAD SPOOLER - ABORT 

("n" IS A WRITE PROTECTED UNIT) 

("a" ISN'T OCTAL #) 

("x" ISN'T SYMBOL) 


answer. 

The system disk (RK0 or DP0 or 
DK0) may be failing. 

Too many digits in answer. 

The disk buffer used to copy (in 
256 word blocks) the spooler into 
memory from the system disk (RK0, 

DP0 or DK0) does not reside in common 
memory. Thus, PIREX cannot move 
the spooler into local PDP-11 
memory. 

The XVM/DOS monitor must have a 
TCB area that can be used by 
"SPOOL". This TCB area is the one 
pointed to by the second entry in 
the TCB table pointed to by . SCOM+IOO. 

An error was detected during I/O 
on the chosen RK unit. Ten re- 
tries were attempted by PIREX and 
the error was not corrected. This 
is either a bad disk cartridge or 
a hardware problem. 

A TCB sent to PIREX was rejected. 


The chosen RK unit has no (0 size) 
spooler area defined on it. 

The spooler (SPOLll) will not fit 
into the remaining LOCAL-11 memory. 

A chosen RK unit is write locked. 

An octal number was expected in 
the answer. 

A symbol (non -numeric answer) was 
expected. 
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UC15 Spooler Error Messages 


MESSAGE 


CONDITIONS 


("n" NON-EXISTENT RK UNIT #) 

(NON-PRINTING CHAR) 

SPOOLER TCB ERROR - ABORT 

SPOOL NOT ON .DAT -14 DEVICE - 
ABORT 

SPOL11 VERSION NOT AT LEAST 
DOS V3B000 - ABORT 


The chosen RK unit does not exist; 
e.g., choosing RK3 on a system 
with only RK0 and RK1 . 

A non-printing character was en- 
tered in an answer. 

The spooler TCB sent to PIREX was 
not accepted. 

The SPOOL program, SPOL15, which 
has printed this error message, is 
not installed on the system device 
under the name SPOOL. The spooler 
SP0L11, cannot be loaded into the 
PDP-11 unless both it and SP0L15 
have been installed in SPOOL on the 
system disk. 

The version of SPOL11 being loaded 
does not seem to be at least 
V3B000. This is determined by the 
presence of the SPOLll size in 
word 0 of the spooler (SPOLll) and 
the entry point offset in word 1. 

If word 0 is equal to 0, this error 
is reported. 
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APPENDIX J 

UC15 SYSTEM ERROR MESSAGES 


The Error Messages from tasks running under PIREX have the following 
format. 


IOPSUC YYY XXXX 


Where YYY denotes on the following: 


EST 

Stop all I/O 

task 

ESD 

Software Driver 

ll 

DTU 

DECtape 

II 

LPU 

Line Printer 

ll 

CDU 

Card Reader 

ll 

GRU 

Plotter 

II 

ESP 

Spooler 

II 

EMA 

MACH 

II 

PRX 1 

PIREX 

Monitor 


XXXX denotes one of the following: 


3 - Illegal interrupt to driver 

4 - Device not ready 

12 - Device failure 

15 - Spooler full warning message 

20 - Spooler disk error-spooling terminated 

25 - IOPSUC XYU 25 means that illegal data is being 

passed to the handler. This error is given under 
the following conditions. 

1. When the mode=6 and the character count 
in the buffer is zero or negative, and 

2. When the mode=2/3/4/5/10/ll fi and Ax or 

Ay is greater than 2^4 (Ax°and A Y re- 
present the change or difference be- 
tween the current X, Y and the previous 
X, Y) . 

27 - IOPSUC XYU 27 means an illegal mode has been 

specified. This message will be given when- 
ever the mode is any value other than 0 - 12 & 

(both inclusive) . 


PRX is shown only in the following message: IOPSUC PRX 4 which 

means that the PIREX executive is not running or that it is excess- 
ively slow in responding. 


J-l 



UC15 System Error Messages 


45 - Greater than 80 column card 

55 - No spooler buffers available 

72 - Illegal punch combination 

74 - Timing error — card column lost — retry card 

75 - Hardware busy — driver not 

76 - Hardware error between cards 

77 - Unrecognized task request — device not present 

400 - Spooler empty — XVM input request pending 

Additional IOPS error messages: 


Error Code 


Meaning 


200 


Non-existent task referenced. 


300 

400 

500 


Illegal API level given (illegal values 
are changed to level 3 and processed) . 

Illegal directive code given. 

No free core in the PDP-11 local memory. 


600 


ALT node for this TCN missing. 


777 


>6 


Request node was not available from 
the POOL ? i . e . , the POOL was empty 
and the referenced task was currently 
busy or the task did not have an ATL 
node in the Active Task List; i.e., 
specific device task was not installed 
in either PIREX or the spooler. 


£><><** 
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INDEX 


Abbreviations, H-l 
Absolute binary object code, 3-8 
Access techniques, file and data, 
4-3 

Acronyms, H-l 
Active slots, 4-1 
API ON/OFF command, 8-25 
ASCII character set, 6-7, A-l, 

F-l 

packing and unpacking, B-l_ 

ASCII data I/O, 2-2, 6-7 
ASCII logical record transfer, 6-3 
Assembly listing, programming 
example, 6-37 

ASSIGN keyboard command, 3-5, 8-15 
Assign UICs, 6-26 

Automatic priority interrupt (API) , 
3-4, 8-25 


Backup tape, 7-3 
Bank mode operation, 3-10 
BANK ON/OFF commands, 8-27 
BATCH command, 8-33 
Batching keyboard commands, 8-32 
Batching mode, 3-4, 8-1 
example, 10-2 
(figure) , 10-7 
restrictions, 8-34, 8-35 
Batch operating software system 
(BOSS) , 2-13 

Binary logical records transfer, 
6-3 

Binary object program, 2-4 
Binary, relocatable, 3-8 
.BLOCK pseudo-op, 6-14 
Bootstrap, 

loading, 7-10 
restarting, 7-11 
Breakpoints, 2-10 
Buffer overflow, 6-6 
Buffer pool, 3-7, 4-11, 5-4, 5-5 
Buffers, 4-2, 6-14 
sizes of, 6-15 
BUFFS command, 8-17 
Building DOS system, 1-11 


Calendar date, 8-28 
Card files, 3-6 
Card reader handler, 9-34 
CHAIN and EXECUTE programs, 2-8 
CHAIN device handlers, 9-9 
CHANNEL 7/9 command, 8-27 
Characters, deletion of, 8-2 
Character set, ASCII standard, A-l 


Checksum error, 6-6, 10-9 
Checksummed binary coded programs, 
3-9 

.CLEAR macro, 6-17 

Clock, real-time, 1-7 

.CLOSE macro, 6-17 

Command batching mode, 3-4, 8-1 

Command default settings, VT15, 

8-25 

Commands , 

batching keyboard, 8-32 
DOSSAV, 7-5, 7-6 
keyboard, 8-1 
loading, 8-18, 8-31 
VT15 display, 8-23 
Comments, 8-30 
COMMON blocks, 2-8 

Communications interface, 1-12, 8-1 
Console switches, 9-39 
Console teleprinter, 3-3, 8-1 
CONTINUE commands, 8-31 
Continue program operation, 8-32 
Core dump, 3-11, 8-20, 8-21 
Core image, 5-2, 8-21 

SAVE-RESTORE commands, 8-20 
Create a file, 8-21 
CTRL commands, 

C, 8-31, 8-33 

D, 8-30 

P, 8-31 

Q, 8-20 

R, 8-32, 8-33 

S, 8-32 

T, 8-32, 8-33 

U, 8-2, 8-24 
X, 1-7, 8-25 


$DATA command, 8-34 
Data files, transfer, 2-11 
Data modes, 4-3, 6-6 
I/O terminators, C-l 
.DAT and . UFDT, 4-9 
Data storage and retrieval, 4-1 
.DAT (device assignment table) , 

3-5 

DATE command, 8-28 
.DAT slot assignments, 6-16, 9-7 
DDT device handlers, 9-6 
DDT program, 2-10 
DECdisk equipment, 1-7 
DECsystem-10/XVM communications 
link, 1-12 

DECtape file structure, 4-4, 4-6 
DECtape handlers, 9-18 
Default device associations, 3-4 
Default protection code, 3-7, 4-10 
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Deletion of characters, 8-2 
Device assignments, 4-1, 8-13 
Device assignment table (.DAT), 

3- 5, 6-16, 8-13, 8-15 
Device capabilities, 6-29 
Device dependence, 6-31 
Device handler characteristics, 

6- 29 

Device handler descriptions, 9-12 
card reader, 9-34 
DECtape 9-18 
disk, 9-20 
line printer, 9-31 
magnetic tape, 9-25 
paper tape punch, 9-15 
paper tape reader, 9-17 
teleprinter, 9-12 
UC15 plotter, 9-37 
VP15A storage tube display, 

9-35 

Device handler loading, 2-10 
Device handler name, 9-1 
Device handlers, 3-2, 3-4, 3-5, 

4- 2, 9-1 
CHAIN, 9-9 
DDT, 9-6 
DUMP, 9-8 

EDIT, EDITVP , and EDITVT , 9-6 
FOCAL, 9-5 

FORTRAN IV (F4) , 9-3 
8 TRAN , 9-10 
EXECUTE, 9-9 
Linking Loader, 9-6 
MACH, 9-4 
MACRO, 9-4 
MCLOAD, 9-11 
MTDUMP , 9-10 
PATCH, 9-8 
PIP, 9-7 
SGEN , 9-7 
SPLGEN, 9-11 
SPLOAD, 9-11 
SPOOL, 9-11 
SRCCOM, 9-9 
UPDATE, 9-8 

Device independence, 3-4, 6-31 

Direct access, 4-4 

Directoried data access (figure) , 

4-7 

Directoried device, 3-6 
Directories on DECtape, 4-6 
Directory initialization, 6-18 
Disk data access (figure) , 4-8 
Disk cartridge, 1-7 
Disk file organization, 4-7, 4-10 
Disk handlers, 4-11, 9-20 
Disk pack, 1-7 

Disk restoration (DOSSAV) , 7-1, 

7- 3 


Display modes, 8-23 
.DLETE macro, 6-18 
DOS monitor, 3-1 
DOSSAV, disk restoration, 7-3 
commands, 7-5, 7-6 
error messages, 7-8 
I/O device combinations, 7-6 
restart procedures, 7-9 
DOS system macros, 5-1 
DR11-C device interfaces, 1-6 
DR15-C device interface, 1-6 
Dump core, 8-20, 8-21 
DUMP device handlers, 9-8 
Dump mode, 6-12 
Dump programs, 2-10, G-l 


EDIT, 2-11 

EDIT, EDITVP, and EDITVT device 
handlers, 9-6 
EDITVP, 2-11 
EDITVT, 2-11 
8 TRAN, 2-12 

device handlers, 9-10 
$END command, 8-34 
End-of-file condition, 8-30 
End-of-file error conditions, 10-9 
End-of -medium error conditions, 
10-9 

.ENTER macro, 6-18 
Error checking, 3-10 
Error codes, IOPS , D-l 
Error condition check, 8-28 
Error detection, 8-35, 10-9 
Error messages, 

DOSSAV, 7-8 
Loader, E-l 
UC15 spooler, 1-1 
UC15 system, J-l 
Error message types, 10-10 
EXECUTE, 2-8 

device handlers, 9-9 
$EXIT command, 8-34 
.EXIT macro, 5-6 


File and data access techniques, 
4-3 

File (definition) , 4-2 
closing, 6-17 
creation, 8-21 
deletion, 6-18 
integrity, 6-44 
organization on disk, 4-10 
protection, 3-7, 4-10, 8-11 
status, 6-19 

structure, 3-6, 4-1, 4-3 
transfer, 2-11, 6-25 
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FILL ON/OFF command, 8-26 
Flags, 6-17 

FOCAL interpreter, 2-5 
device handlers, 9-5 
FORTRAN IV compiler, 2-1 
device handlers, 9-3 
. FSTAT , 6-19 

.FULL and .FULLP binary, 3-9 


GET command, 8-21 
•GET macro, 5-3 
Globals, 3-9 
. GTBUF macro, 5-4 
. GVBUF macro, 5-5 


HALF ON/OFF command, 8-25 
HALT command, 8-30 
Handler - see Device handler 
Hardware, 1-3, 1-6 
Header word pair, 4-2, 6-4, 6-5, 
6-6 

Hollerith code, F-l 


Image modes, 6~ 10 
Initialize bit maps and direc- 
tories , 6-17 

Initialize device and device 
handler, 6-20 

Initialize directory, 6-18 
. INIT macro, 6-20 
Input/Output (I/O) 
buffers, 3-7, 6-14 
communication, 3-4, 6-1 
data mode terminators, C-l 
device assignments, 8-13 
device handlers, 3-2, 3-5, 9-1 
DOSSAV device combinations, 7-6 
errors detected, 3-11 
macros, 6-2, 6-30 
macro syntax, 6-29 
INSTRUCT command, 8-6 
Integrity of files, 6-44 
. IODEV pseudo-op, 6-16 
IOPS ASCII packing and unpacking 
routines, sample, B-l 
IOPS binary, 6-9 
IOPS error codes, D-l 
IOPS modes, 6-7 


$ JOB command, 8-33 


KEEP command, 8-15 
KEEP ON/OFF command, 8-17 
Keyboard, 3-3 

commands, 8-1, 8-2 
operations, 10-1, 10-2, 10-3 


Languages, 2-1 

Library UPDATE program, 2-12 
Line, deletion of, 8-2 
Line printer handler, 9-31 
Line printer output, 8-27 
Linkage, program, 3-9 
Linking loader, 2-3, 2-9 
device handlers, 9-6 
errors, E-l 
Loader control, 3-9 
Loader errors, E-l 
Loading, 

bootstrap, 7-10 

core image program, 5-5 

external subroutines, 2-9 

monitor, 7-10 

PIREX, 7-2 

program, 3-10 

Loading commands, 8-18, 8-31 
LOG command, 8-30 
Logical record, 6-3 
format, 6-4 

terminators, 6-12, 6-13 
transfer, 6-27 
LOGIN command, 8-11 
LOGOUT command, 8-12 
Looping, 10-9 
LP ON/OFF command, 8-27 
LV11 Electrostatic printer/plotter 
raster scan package, 1-12 


MAC 11 assembler, 2-4 
device handlers, 9-4 
installation program (MCLOAD) , 
2-14 
Macro, 

descriptions, 6-16 
device handlers, 9-4 
expansions, 5-2 
syntax, 6-29 

Macros, summary of I/O, 6-2 
MACRO XVM assembler, 2-2 
Magnetic tape, 4-5 
DUMP, 2-11 
file structure, 4-5 
functions, 6-21 
handlers, 9-25 

Master File Directory (MFD) , 3-6 
4-8 
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MCLOAD device handlers, 9-11 
Memory 

multiplexer, 1-6 
size, 8-19 
transfers, 2-2 
MEMSIZ command, 8-19 
MICLOG command, 8-12 
MODE command, 8-11 
Modes, data, 4-3 
Modes of operation, 3-10 
Modification of system, 7-12 
Monitor, DOS, 3-1 

Monitor Identification Code (MIC) , 
3-7, 4-8 

Monitor load, 7-10 
Monitor/user interaction, 3-3 
.MTAPE macro, 6-21 
MTDUMP utility program, 2-11 


Nondirectoried devices, 3-6 
Nonresident monitor, 3-1 


Object code, 3-8 
Object program preparation, 2-1 
Open a disk file, 6-21 
Open a file for input, 6-24 
Operating procedures, 10-1 
Optional hardware, 1-4 
Optional software, 1-11 
Output via DUMP, 2-10 
Overflow of buffer, 6-6 
Overlays, 2-8 
. OVRLA macro, 5-5 


Packing and unpackinq routines, 
sample IOPS ASCII, B-l 
Page mode operation, 3-10, 8-24 
PAGE ON/OFF command, 8-27 
Paging mode, VT15 , 9-36 
Paper tape files, 3-6 
Paper tape punch handlers, 9-15 
Paper tape reader handlers, 9-17 
Parity error, 6-6, 10-9 
PATCH device handlers, 9-8 
PATCH utility program, 2-7 
$ PAUSE command, 8-34 
PDP-8 to XVM translator, 2-12 

PDP-11, 1-6 

PIP (Peripheral Interchange Pro- 
gram) , 2-11 
device handlers, 9-7 
PIREX, 3-1 
loading, 7-2 


Plotter, 9-37 

POLLER ON/OFF command, 8-28 
Printer/plotter raster scan package, 
LVll electrostatic, 1-12 
Priority interrupt (PI), 3-4, 8-25 
Program linkage, 3-9 
Program loading, 3-10 
Programming examples, 
assembly listing, 6-37 
source listing, 6-35 
Program relocation, 2-9 
Programs, system, 2-1 
PROTECT command, 8-12 
PUT command, 8-21 
.PUT macro, 5-2 


QDMP XVM program, G-l 
QDUMP , 8-21 


.RAND macro, 6-21 
Random access, 4-4, 6-21, 6-23 
Random- sequential file structure, 
4-4 

.READ macro, 6-22 

.READ/. WRITE/. RTRAN operations, 

6-3 

Real-time clock, 1-7 
Records (definition) , 4-2 
Relocatable binary, 3-8 
Relocatable programs, 2-3, 2-9 
.RENAM macro, 6-23 
REQUEST command, 8-11, 8-13 
Resident monitor, 3-1 
Restart commands, 8-31 
Restart procedures, DOSSAV, 7-9 
Retrieval Information Block (RIB) , 
4-10 

.RTRAN macro, 6-23 
.RTRAN operations, 6-3 
RUBOUT key, 8-2 
on VT15, 8-24 


Sample IOPS ASCII packing and un- 
packing routines, B-l 
SCOM command, 8-3 
Scroll mode, 8-24 
Search feature, DDT, 2-10 
.SEEK macro, 6-24 
Segmentation of programs, 2-8 
Sequences of I/O macros, 6-31 
Sequential access, 4-3, 4-4 
(figure) , 4-6 

Sequential file processing, 6-3 
Sequential files, 3-6 
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SGEN (System Generator), 2-6, 7-12 
device handlers, 9-7 
Sixbit file representation, 5-2 
Size of buffer, 6-14, 6-15 
Software, 1-7, 1-8, 1-10, 1-11 
Source coding, 2-4 
Source Compare Program (SRCCOM) , 
2-12 

Source listing, programming 
example, 6-35 

SPLGEN device handlers, 9-11 
SPLOAD device handlers, 9-11 
SPOOL device handlers, 9-11 
Spooler control program (SPOOL) , 

2- 13 

Spooler disk area generation 
(SPLGEN) , 2-13 
Spooler error messages, 1-1 
Spooler installation program 
(SPLOAD) , 2-13 
Spooling, 3-11 
SRCCOM device handlers, 9-9 
Start commands, 8-31 
Startup procedures, 7-2 
Status of a file, 6-19 
Storage, 3-6, 4-1 
Storage tube display, 9-35 
Switches, console, 9-39 
Symbol tables, 2-9 
. SYSID macro, 5-7 
System build, 1-11 
System communication table (SCOM) , 

3- 2 

System device, 1-7 
System error messages, UC15, J-l 
System generator (SGEN), 2-6, 7-12 
System information, 8-3 
System initialization, 7-1 
System loader ( . SYSLD) , 3-2 
System macro summary, 5-1 
System manager, 3-7 
System modification, 7-12 
System parameters, 5-7 
System program loading commands, 
8-31 

System programs, 2-1 
System software, see Software 


TAB ON/OFF command, 8-26 
Teleprinter, console, 8-1 
device handler, 9-12 
Terminal errors, 3-11 
Terminators, 

input/output data mode, C-l 
logical record, 6-12, 6-13 
Terms and acronyms, H-l 
Text editor programs, 2-11 


Text string inserted into an 
assembler statement, 5-7 
TIME command, 8-29 
.TIMER macro, 5-6 
TIMEST command, 8-29 
.TRAN macro, 6-25 
.TRAN operations, 6-3 
Transfer binary logical records, 
6-3 

Transfer data files, 2-11 
Truncated files, 6-44 


UC15 ON/OFF command, 8-30 
UC15 spooling error messages, 1-1 
UC15 system error messages, J-l 
UC15 XY11/XY311 plotter device 
handler, 9-37 
UDMP11 program, G-2 
. UFDT and .DAT, 4-9 
. UFDT slot, 8-17 
Unchecksummed binary, 3-9 
UNICHANNEL-15 hardware, 1-6, 1-7 
UPDATE device handlers, 9-8 
User File Directory (UFD) , 3-6, 

4-8 

User File Directory Table (.UFDT), 
3-6, 4-9, 8-13, 8-15 
User Identification Code (UIC) , 
3-6, 4-8, 6-26 
.USER macro, 6-26 
User-system interface, 3-3 


VP15A graphics software, 2-13 
VP15A storage tube display handler, 
9-35 

VT15 display commands, 8-23 

VT ON/OFF command, 8-24 

VT15 XVM graphics software, 2-12 


WAIT command, 6-22 
.WAIT macro, 6-27 
. WAITR macro, 6-27 
Word count, 6-4, 6-6, 6-13 
Word pair count, 6-4, 6-6, 6-13 
Words (definition) , 4-2 
.WRITE macro, 6-27 
.WRITE operations, 6-3 


XVM mode, 3-10 

XVM ON/OFF command, 8-19 
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NOTE: This form is for document comments only. Problems 

with software should be reported on a Software 
Problem Report (SPR) form. 


Did you find errors in this manual? If so, specify by page. 


Did you find this manual understandable, usable, and well-organized? 
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Is there sufficient documentation on associated system programs 
required for use of the software described in this manual? If not, 
what material is missing and where should it be placed? 


Please indicate the type of user/reader that you most nearly represent. 
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| | Higher-level language programmer 
[ | Occasional programmer (experienced) 

1 | User with little programming experience 
| | Student programmer 

LJ Non-programmer interested in computer concepts and capabilities 
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